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PREFACE 


This manual is the prime document for the DOS-15 Monitor Software 
System and describes its features, concepts, programming, and opera- 
ting procedures. The first four chapters provide a general descrip- 
tion of the DOS-15 System components, both hardware and software, 
fundamental system concepts, and file structures. 

The remaining six chapters deal with the DOS-15 system at a more 
technical level. They are primarily concerned with I/O programming 
requirements and techniques under the Monitor, runtime keyboard com- 
mands, and operating procedures. The information in these chapters 
is directed primarily to readers who are familiar with either the 
FORTRAN IV language or the PDP-15 assembly language, MACRO-15 (de- 
scribed in DEC-15-GFWA-D and DEC-15-AMZC-D, respectively) . FORTRAN 
users, however, need only be concerned with Chapters 7, 8, and 10, 
since FORTRAN I/O considerations are specifically covered in the 
PDP-15 FORTRAN IV Operating Environment manual (DEC-15-GFZA-D) . 

Detailed information on the internal operations of the DOS-15 Monitor 
and its file structure as well as procedures for preparing user- 
created system software are provided in the DOS-15 System Manual 
( DEC-15-NRDA-D) . 3rief descriptions of all system programs with 
applicable document numbers are contained in Chapter 2. 

A quick reference summary of the command strings, operating procedures 
and error messages for the Monitor and system programs is provided in 
the DOS-15 Keyboard Command Guide (DEC-15-NGKA-D) . 
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CHAPTER 1 


DISK OPERATING SYSTEM 


1 . 1 INTRODUCTION 

The PDP-15 Disk Operating System (DOS-15) is an integrated set of 
software designed to meet the demands of research, engineering, 
and industrial environments. It includes the software necessary 
■for -SlIT.pl-1-f M r G m I' ATTuu 1 1 1U find dTTl (-1 enr dpora done - DOC -l£ 
brings to the user the advantages of disk resident storage via 
rapid access to the system's resources. The operating system 
runs with a PDP-15/20 Central Processor having at least 16,384 
18-bit words of main memory and the specific capabilities required 
by the system (see Paragraph 1.2, "System Hardware"). 

The System Monitor is an integrated set of commonly-used programs 
for the development of user applications. These programs include 
tools for: 

Program Preparation, 

Compilation , 

Assembly , 

Debugging, and 

Execution of User Programs. 

The DOS Monitor, the heart of the system, incorporates all the func- 
tions of the "Advanced Monitor System" plus the added power of 
fully automatic random access file operation. The user controls 
the operating system by instructions to the Monitor. The Monitor 
runs the jobs, supervises data and file manipulation, and interacts 
with the operator/user in a simple, conversational manner. 

In the operating system, data on mass storage is handled by macro 
statements used with the MACRO-15 symbolic assembler language, and 
by the mass storage language elements incorporated into the FORTRAN 
IV compiler. 
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1.1.1 System Features 


Disk Resident 
System Software 

Interactive 

Operation 

I/O Device 
Handlers 

Programmed 

Monitor 

Commands 

Conversational 

Mode 

Dynamic Storage 
Allocation 

Dynamic Buffer 
Allocation 

Disk File 
Structure 


All DOS-15 System Software resides on either 
DECdisk or Disk Pack. 

An interactive keyboard/program Monitor permits 
device-independent programming and automatic 
calling and loading of system and user programs. 

Data and file manipulating I/O device handlers 
dre supplied for standard system peripherals. 

Input/Output programming is simplified by the 
use of a set of system commands which are 
standardized for system-supported I/O devices. 

System Utility Programs interact with the operator/ 
user in a simple, conversational manner. 

The available disk storage is automatically allo- 
cated for optimum storage utilization. 

Input/Output core is automatically optimized by 
the Monitor. It allocates only that space which 
is required for the system and the user. 

Allows the most efficient use of disk capacity 
and data retrieval for processing via: 

o System supported DECdisk and Disk Pack 

devices, providing both economy and 
storage capacity 

o Virtually unlimited data capacity (Disk 

Pack = 83.7 million words, DECdisk - 2.09 
million words) 

o Random/Sequential File access 

o File Protection through unique user 

directories 
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o 


User/user file independence - identically 
named unformatted Input/Output (FORTRAN-IV) 

o Random Access - formatted as well as 
unformatted Input/Output (FORTRAN-IV) 

The user may easily incorporate his own software 
into the operating system, thereby tailoring the 
system to his hardware and software needs. 

Programming Several programming languages are offered: 

Languages FORTRAN IV, FOCAL, MACRO-15. 

Choice of 8K (Bank Mode) or 4K (Page Mode) 
direct addressability. Bank Mode permits 
DOS-15 operation on the PDP-9. 

The system provides for several levels of user file protection. Using 
unique User Identification Codes, each user can be assured of his 
file integrity. Files are protected and invisible to other users. 

The system provides privileged access to all files via a supervisory 
code maintained by the system owner or manager. 

1 . 2 SYSTEM HARDWARE 

The Disk Operating System is defined within the limits of a particular 
PDP-15 hardware system configuration; i.e., central processor model, 
minimum and maximum core requirements, necessary features, and types 
and numbers of peripheral devices. 

The system software is distributed as a Disk Restore System on 
DECtape or Magtape, and operates from DECdisk or Disk Pack with 
DECtape or Magtape backup storage. 

1.2.1 Minimum Hardware Requirements 

The minimum equipment configuration for the DOS-15 software includes 
the PDP-15 Central Processor with the following features: 

16,384 18-bit, 800-NS core memory 
35 Teleprinter 

PC 15 High-speed Paper Tape Reader and Punch 
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KE15 Extended Arithmetic Element 
TCI 5 DECtape Control 

1 TU56 Dual DECtape Transport or 2 TU55 DECtape 
Transports, 
or 

TC59 Magtape Control 

1 TU10, TU20, or TU30 Magnetic Tape Transport 
(7- or 9-track) 

RF15 DECdisk Control 

1 RS09 DECdisk Drive (262,144 words) 
or 

RP15 Disk Pack Control 

1 RP02 Disk Pack Drive (10.24 million words) 

1 RP02D Disk Pack 

The PDP-15 hardware environment is illustrated in Figure 1-1. 
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1.2.2 Optional Hardware 


Additional hardware supported by the operating system is as follows: 


up to 32,768 18-bit, 800-NS core memory 

KA15 Automatic Priority Interrupt 

KW15 Real Time Clock 

FP15 Floating Point Processor 

35 and/or 33 Teleprinter or LA30 DECwriter 

PC15 High Speed Paper Tape Reader and Punch 

TC15 DECtape Control 

4 TU56 Dual or 8 TU55 DECtape Transports 
RF15 DECdisk Control 

8 RS09 DECdisk Drives (262,144 words per drive) 

RP15 Disk Pack Control 

8 RP02 Disk Pack Drives (10,240,000 words per drive) 

TC59 Magtape Control 

8 TU10 , TU20 or TU30 (7- or 9-track) Tape Transports 
Card Readers 

CR03B 200 cpm Reader and Control 
or 

CR15 1000 cpm Reader and Control 
VP15 Point Plotting Displays 
VT15 Graphic Display Processor 

VT04 Graphic Display Console 

LK3 5 Keyboard 
Line Printers 

LP15 - 1000 1pm, 132 column line 
or 

- 356 1pm, 80 dolumn line 
VWA Writing Tablet 

1.2. 2.1 CTRL X Feature - The Control X feature is available to the 
user whose system configuration includes a VT15 Display Processor or 
a VT04 Display Console. This feature gives the capability of changing 
from the hard copy output of the teleprinter to the soft copy output 
of the VT15 Display. 
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1.2. 2. 2 Real-Time Clock - The Real-Time Clock (on systems having 
this option) runs continuously, in order to update an elapsed time 
register. It can be used by the user to time jobs or to control 
program execution. 


In addition to the above, the user may adapt the system to incorporate 
many other specialized peripherals, such as X-Y plotter, data acquisi- 
tion equipment, etc. 

1.2.3 The System Device 

The system device for DOS-15 may be either the RF15 DECdisk, or the 
RP02 Disk Pack. 

The RF15 DECdisk equipment is composed of up to eight fixed-head, 
rotating disks which are treated by DOS as one contiguous storage 
area. The DOS Monitor provides for simultaneous use of the DECdisk 
or Disk Pack as a system device, file device, and scratch device. 

1.3 SYSTEM SOFTWARE 

The PDP-15 Disk Operating System's service routines perform four pri- 
mary tasks for all user applications (see Figure 1-2) . 

1. Run-Time Aids - External routines from several 
libraries are available to the user. The li- 
braries may contain either user -designed routines 
or those provided by DOS-15 which can be implicitly 
or explicitly called. 

2. Utilities - DOS-15 provides facilities for 
efficient storage, flow, and retrieval of system 
and user data. There are also system programs 
that provide file verification and data buffer 
allocation, file data manipulation, etc. 

3 . Program Preparation and Maintenance - There are 
system programs to aid user program preparation 
by preparing file text for source programs and 
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Figure 1-2 

PDP-15 Monitor Disk Operating System Software 
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programs to aid testing and maintenance of 
object programs. 


4. Language Assembly and Compilation - Programs are 
available to translate problem-oriented and pro- 
cedure oriented languages into machine language 
and to incorporate routines into complete, executable 
programs . 

The system software lets the user deal with many complex problems in 
a simple and straightforward manner. The system will perform all of 
these functions: 


1. 

Write programs in three higher-level 
FORTRAN IV, FOCAL and MACRO-15. 

languages - 

2. 

Edit and debug the program prior to 

run. 

3. 

Load and link programs. 


4. 

Run the program by: 



a. handling I/O, 

b. reading and writing named random-access files 
on disk storage, 

c. providing run-time device independence, 

5. Batch process from paper tape or cards. 

Listed in Table 1-1 are individual system programs in the PDP-15 
Disk Operating System. 


Table 1-1 DOS System Software 


System Functions 

Program Name 

Description 

MONITORS 

DOS-15 Monitor 

Allows system parameter 
changes and device as- 
signments . 

LANGUAGES 

FORTRAN IV 

Compiler, Object Time 
System, Science Library. 

FOCAL 

An on-line interactive 
algebraic language. 

MACRO- 15 

A symbolic assembler 
language . 
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Table 1-1 DOS System Software (Cont’d) 


System Functions 


Program Name 



Description 


A Dynamic Debugging Tech- 
nique for FORTRAN and 
MACRO programs . 

The capability to output 
specified core locations. 

Text Editor providing 
insertion, deletion, and 
modification of symbolic 
text. 

Special versions of EDIT 
which provide fast soft 
copy editing on the VT or 
VP display system. 


Facilitates the manipula- 
tion and transfer of 
data files from any input 
to any output device. 

High-speed DECtape copy 
program. 

Binary program retrieval 
and library update program. 

Source compare program. 

Magnetic Tape DUMP program. 

Translates PDP-8 source 
code into PDP-15 code. 

Translates PDP-8 source 
code into PDP-9 code. 


Provides the ability to 
tailor the system struc- 
ture to a particular hard- 
ware/software configuration. 

Makes corrections to sys- 
tems programs on the 
systems device, and adds 
programs to the system. 


Loads relocatable programs 
and required routines. 

Multiple segmentation of 
large programs and overlays 
to allow economy of core. 
















These programs are supervised by the Monitor to form an interactive 
collection of service programs. This relationship is illustrated in 
Figure 1-2. 


1.3.1 How DOS is Supplied 

General purpose software is supplied to the PDP-15 user on two 
DECtapes or one 7- or 9-track magnetic tape as a disk-restore initiali- 
zation. The DOS-15 System tape(s) j contain all of the standard PDP-15 
DOS System Programs, Utility Programs, and I/O Device Handlers sup- 
plied and supported by Digital Equipment Corporation. An unmodified 
master system tape or tapes should be maintained as a reference back- 
up system. Users with the FP-15 Floating Point hardware are provided 
with additional FP-15 routines on DECtape or Magtape. 

1.3.2 DOS Checkout Package 

Digital Equipment Corporation supplies a checkout package for the 
DOS- 15 which allows the user to te$t the System software for proper 
installation on DECdisk or Disk Pa£k. The package is available on 
batch paper tapes in two versions,. as follows: 

RF.CHK For the RF15 DECdisk system ( DEC- 15-CI DA-PA) 

RP.ChK For the RP02 Diski Pack system (DEC-15-CIAA-PA) 

These programs provide the user with the ability to briefly test all 
the basic system software supplied for DOS-15. For more information, 
refer to Appendix G, DOS-15 Checkout Package. 



CHAPTER 2 


SYSTEM PROGRAMS 


2.1 INTRODUCTION 

This chapter gives information necessary for the System's Manager and 
Analyst to evaluate system programs to be run under DOS-15 control. 
Each system program will assist the user in performing a particular 
task in the process of application design and implementation. Con- 
siderations for system modification are reserved for DOS System Manual 
DEC-15-NRDA-D. 

2.2 CHOICE OF LANGUAGES 

User source programs can be implemented at several levels depending 
on those particular system features required for a given processing 
environment. DOS-15 supports three levels of automation for object 
program preparation: 

1. Compiler level language - FORTRAN IV 

2. Assembly language - MACRO-15 

3. Interpretive language - FOCAL 

2.2.1 FORTRAN IV Compiler 

The PDP-15 FORTRAN IV compiler is a higher-level, procedure-oriented 
language system that accepts statements written in the FORTRAN IV 
language and produces a relocatable object program capable of being 
loaded by the Linking Loader. All versions of PDP-15 FORTRAN IV 
are based on the language of USASI Standard FORTRAN (X3. 9-1966). The 
system is augmented by the Floating Point Processor, the FORTRAN IV 
compiler, and an Object Time System. 

Object time program capabilities include "floating point" instructions 
Subroutines written in either FORTRAN IV or MACRO-15 assembly language 
can be loaded with and called by FORTRAN IV main programs. Compre- 
hensive source language diagnostics are produced during compilation, 
and a symbol table is generated for use in on-line debugging with DDT. 
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The system's Data-Directed Input-Output package permits input or out- 
put of ASCII data without reference to a FORMAT statement. The 
system can also perform memory-to-memory transfers (Encode/Decode) 
moving data from memory to the I/O Buffer to memory. 

There are three versions of the FORTRAN IV supported by DOS-15: 

(1) F4X (PDP-15 mode); (2) F4X9 (BANK mode) ; and (3) FPF4X (Floating 
Point mode) . Each version has its own Object Time System and Science 
Library so that program routines may utilize all system hardware and 
software features. 

A FORTRAN IV program may be compiled and run in several different equip- 
ment environments. The FORTRAN programmer need not be too concerned 
with the details of his environment since the FORTRAN Object-Time Sys- 
tem (OTS) will ensure that his source statements generate the appropri- 
ate computer instructions. For example, an arithmetic statement such 
as A=A*B will appear the same in any FORTRAN IV program. In the object 
program it may be transformed to a subroutine call or a floating point 
instruction, depending on the hardware configuration on which the pro- 
gram is produced. FORTRAN data-transmission statements automatically 
call a number of OTS subroutines which serve as an interface between 
the user program and the Monitor. These routines may also be called from 
MACRO-15 assembly language programs. Further, programs written in 
FORTRAN IV can be linked to programs or routines written in the MACRO-15 
assembly language. 

For more information concerning this higher-level programming language, 
refer to Volume One and Volume Two of the FORTRAN IV Reference Manual 
(DEC-15-GFWA-D ) . 

2.2.2 MACRO Assembler 

The MACRO Assembler provides users with highly sophisticated macro 
generating and calling facilities within the context of a symbolic as- 
sembler. Some of the prominent features of MACRO-15 include: 

The ability to: 

(a) define macros, 

(b) define macros within macros (nesting) , 

(c) redefine macros (in or out of macro definitions) , 

(d) call macros within macro definitions, 

(e) have macros call themselves (recursion) 

(f) combine up to three input files for one assembly. 
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2. Conditional assembly based on the computational results 
of symbols or expressions. 

3. Repeat functions. 

4. Boolean manipulation. 

5. Optional octal, symbolic, and cross-reference listings. 

6. Two forms of radix control (octal, decimal) and two 
text modes (ASCII and 6-bit trimmed ASCII) . 

7. Global symbols for easy linking of separately assembled 
programs . 

8. Choice of output format: relocatable, absolute binary 
(check summed) , or full binary — capable of being loaded 
via the hardware READIN switch. 

9. Ability to utilize user-designed input/output macros. 

10. A Table of Contents option containing the page numbers 
and text of all assembled .TITLE statements in the 
program. 

MACRO-15 permits the programmer to use mnemonic symbols to represent 
instruction operation codes, locations, and numeric quantities. It 
is essentially a comprehensive macro instruction generator. This 
generator permits easy handling of recursive instruction sequences, 
changing only the arguments. 

The assembler facilitates the development of instructions called 
"macros" which, when used as a source statement, can cause a specific 
sequence of instructions to be generated in the object program. 

Refer to the PDP-15 MACRO-15 Assembler Manual (DEC-15-AMZC-D) for a 
complete description of the language. 

The standard object code produced by MACRO-15 is in a relocatable format 
which is acceptable to the Disk Operating System's Linking Loader 
utility program. Relocatable programs that are assembled separately 
and use identical global symbols 1 where applicable, can be combined by 
the Linking Loader into an executable program. 

An output listing, showing both the programmer's source coding and the 
binary object program produced by MACRO-15, is printed if desired. 

Symbols which are referenced in one program and defined in another. 
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This listing includes all the symbols used by the programmer with 
their assigned values. If assembly errors are detected, erroneous 
lines are marked with specif ic letter error codes. 

2.2.3 FOCAL Interpreter 

FOCAL (Formulating On-line Calculations in Algebraic Language) operates 
in on-line conversational mode, using natural language and arithmetic 
terms to establish a simplified environment for the computer aided 
solution of business and scientific arithmetic problems. Included in 
FOCAL are such features as: 

1. Linkage to assembly language (MACRO) routines to establish 
a user library of commonly used functions. 

2. Use of COMMON to facilitate chaining in the same manner 
as FORTRAN IV. 

With FOCAL, the user can generate mathematical models, plot curves, 
solve sets of simultaneous equations in n-dimens ional arrays, and do 
much more. Refer to the PDP-15 FOCAL-15 Manual (DEC-15-DJZB-D) for 
a complete description of this program. 

FOCAL library commands allow the user to save and then call programs 
by name. These commands result in files consistent with the DOS 
file format. Such files can be manipulated by other DOS programs, 
such as PIP and EDITOR. FOCAL has commands which allow the segmenta- 
tion (chaining) of FOCAL programs. 

The ability to write FOCAL functions in MACRO assembly language and 
subsequently interface these functions with the FOCAL interpreter 
is an important feature. These functions are processed in the same 
way as the normal internal functions which DEC supplies with the 
interpreter . 

2.3 SYSTEM GENERATOR (SGEN) 

The System Generator (SGEN) is a standard DOS Utility program 
used to modify disk resident system files. SGEN, provided as part 
of the general-purpose package, enables the user to tailor his sys- 
tem and add to the supplied software in order to develop a resident 
software system unique to the installation or to his specific needs. 
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The user (System Manager) calls the system generator program via the 
Monitor command "SGEN" . When SGEN is loaded, it initiates an inter- 
active question/answer sequence regarding the following system func- 
tions and parameters: 

1. Existence of an extra memory page, 

2 . Options , 

3. Type of printer unit used, 

4. Required device handler designations (i.e., the 
standard I/O configuration the user wants for 
the system programs) , 

5. Skip-Chain information - Priority Interrupt 
Skip Chain contents and order, 

6. Default assumptions , including: type of tele- 
printer used, use of additional 4K of core, etc., 

7. System device designation, 

8. .DAT slot assignments, 

9. Monitor Identification Code to designate the 
privileged access by the System Manager, 

10. Default buffers that are needed at any time during 
a user program, 

11. Default Files Protection Code. 

Careful planning is necessary to ensure that the most efficient system 
will be developed for the user's particular needs. For more informa- 
tion, refer to the DOS-SGEN Utility Program Manual , (DEC-15-YWZB-DN12 ) . 

2.4 PATCH UTILITY PROGRAM 

PATCH is used to: (1) make corrections to the binary version of system 
programs on the system device, (2) examine and change any word in any 
DECdisk or Disk Pack block, or (3) convert relocatable binary programs 
into system programs. Further, it has the capability of patching all 
system software. 

Facilities - provide for: 

1. The selection, examination and alteration of registers 
within DOS System programs, and any data word block on 
mass storage, including the system information blocks, 

SYSBLK and COMBLK; 


2-5 



2 . 


The installation of suitable relocatable programs 
into a user system as a non-relocatable System pro- 
gram; 

3. The loading of absolute programs into a user system 
as a System program. 

The PATCH user must first be logged in under the Monitor Identification 
Code (MIC) to have access to system files. Binary programs which are 
not in system program format (e.g., relocatable link-loadable programs, 
and XCT programs which are executable files built by the System pro- 
gram CHAIN) cannot readily be corrected by using PATCH. 

With PATCH the user can: 

1. Select a System program to be patched. 

2. Select a single block to be patched. 

3. Obtain an octal printout of the contents of a par- 
ticular location in a program. 

4. Alter the content of the listed location by simply 
typing the desired content in octal. 

5. Use the READ command to either replace or patch a 
system program via Paper Tape input. This enables 
the user to easily make corrected copy available for 
instant use without requiring reassembly, regenera- 
tion of a system or core patching. This is most use- 
ful for handling small updates or new versions of a 
program. 

6. Select and open specific word locations within 
SYSBLK or COMBLK. 

7. Select and examine registers within a system +Q area. 

8. Automatically convert relocatable binary files into 
system program format and load the converted file 
onto the system device, provided disk space has been 
reserved by SGEN. This feature permits user programs 

to be called directly from the Monitor. It also enables 
the program to completely overlay its loader, to make 
the most effective use of core storage. 

For more information concerning this System Utility program, refer to 
the PATCH Utility Program Manual (DEC-15-YWZB-DN5) . 
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2.5 CHAIN AND EXECUTE PROGRAMS 

The programs CHAIN and EXECUTE allow the user to segment programs in 
order to construct and run a system of core overlays in an easy and 
straightforward manner. 

CHAIN reserves portions of user core (called COMMON blocks) from one 
segment to another so that the program segments can communicate. The 
FORTRAN IV compiler and the MACRO-15 assembler can reserve COMMON 
blocks for future segmentation. This method of segmentation permits 
multiple overlays of executable code, constants, variables, arrays, 
and labeled COMMON blocks. 

Both system programs are required for segmentation: 

1. CHAIN - processes a version of the Linking Loader 
Code (Object Program code) allowing the user to 
build all the various segments (or chains) of his 
program into an absolute (not relative) executable 
(XCT ) type file. 

2. EXECUTE - a control program which initiates loading 
of an executable file and transfers control from one 
segment chain to another. At load-time, Execute is 
faster than the Linking Loader. 

CHAIN organizes subroutines into units called LINKS, which may overlay 
each other. Several LINKS may overlay a larger LINK without overlay- 
ing each other. A LINK is loaded into core when a subroutine within 
the LINK is called, and remains resident until overlayed. A LINK's 
core image is not recorded or "swapped out" when it is overlayed. The 
same image is brought into core each time a LINK is loaded. For maxi- 
mum run-time efficiency, segments must be processed serially. See 
the PDP-15 CHAIN and EXECUTE Manual for detailed instructions 
(DEC-15-YWZB-DN2 ) . 

2.5.1 Advantages/Disadvantages of CHAIN & EXECUTE 

2. 5. 1.1 Advantages 
1. CHAIN 

a. Can build an operable program whose core requirement 'is 
larger than that of the run-time machine; 

b. Can be used to create elaborate overlay structures; 

c. Is more efficient than using the .OVRLA System Macro 
(see 5. 2. 2. 5) ; 
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d. Allows the user to request a detailed load map; 

e. Generates core image files which are smaller than 
relocatable binary files. 

2 . EXECUTE 

a. Its loader is more core efficient than the Link- 
ing Loader since Linking Loader code is processed 
only once; 

b. Is smaller at load titne than the Linking Loader; 

c. Gives faster execution times. 


2. 5. 1.2 Disadvantages 


1. One additional step is required to process Object Code 
in preparation for run time. 

2. DDT (Dynamic Debugging Technique) cannot be used with 
a segmented program. 

3. At run-time, the execution of a segmented file requires 
a certain amount of processing overhead. 


2 . 6 LINKING LOADER 

The Linking Loader loads any FORTRAN IV or MACRO object program which 
exists in relocatable format. Its tasks include relocation of programs, 
loading of called external subroutines , retrieval and loading of im- 
plied subroutines, and building and relocation of the necessary symbol 
tables. See "Linking Loader" in the PDP-15 Utility Programs Manual 
(DEC-15-YWZB-DN8 ) for detailed instructions. 

The loader first loads all the named programs included in the keyboard 
command string. It then additionally loads and links all requested 
library subprograms. The requested library subprograms are loaded 
from the device handler directory (IOS) , the external (user) -library, 
if one exists, and the bank or page mode system library (BNK or PAG). 

In addition, the loader can type out a core map which specifies the 
name ^nd address of each program, subprogram, library routine, . GLOBL 
and common block loaded. 
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2.7 DYNAMIC DEBUGGING TECHNIQUE (DDT) PROGRAM 


DDT provides on-line debugging facilities that enable the user to load 
and operate his program in a real-time environment while maintaining 
strict control over each program section. DDT allows the operator to 
insert and delete breakpoints, examine and change registers, patch 
programs, and search for specific constants or word formats. 

A breakpoint halts operation when the program flow arrives at the 
designated location. The DDT breakpoint feature allows the insertion 
and simultaneous use of up to four breakpoints, any or all of which 
may be removed with a single keyboard command. The search facility 
allows the operator to specify a search through any part or all of 
an object program with a printout of the locations of all registers 
that are equal (or unequal) to a specified constant. This search 
feature also works for portions of words, as modified by a mask. 

With DDT, registers may be examined and modified in either instruction 
format or octal code, and addresses may be specified in symbolic rela- 
tive, octal relative, or octal absolute. Patches may be inserted in 
either MACRO source language or octal. For more information, refer 
to the Dynamic Debugging Technique, Utility Program (DEC-15-YWZB-DN1) . 


2.8' DUMP PROGRAM 


DUMP gives the user the ability to output, on any device specified, 
core locations that have been preserved on disk via the CTRL Q (to) 
Monii 


t- 1 -C- pro VI au . l j. r oy co crump uisctape or 
blocks nntn any Por more intui ma Liuu icier co t ne Key - 

board Command Guide (DEC-15-NGKA-D) . 


2.9 MAGNETIC TAPE DUMP (MTDUMP) UTILITY PROGRAM 


The MTDUMP program provides the user who employs magnetic ta£>e as a 
storage medium with the ability to view and manipulate any named 
portion (i.e., file) of a tape. 

Some of the features provided by MTDUMP are: 

a. Files may be output (dumped) onto any system device 
in any of four possible formats. 

b. Comments may be inserted into a DUMP file. 
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c. Files may be copied onto another tape. 

d. Magtape directories can be listed and cleared. 

For more information, refer to the MTDUMP , Utility Program 
(DEC-15-YWZB-DN4 ) . 

2.10 TEXT EDITOR PROGRAMS, EDIT, EDITVP AND EDITVT 

The Text Editor provides the ability to read alphanumeric text from 
paper tape, DECdisk and Disk Pack, DECtape, etc. 

The user can then examine and correct the text, writing it back on 
paper tape. Disk Pack,, DECdisk, and DECtape devices. Programmers 
can also use the Text Editor to create new symbolic programs. 

The Editor operates on lines of symbolic text delimited by carriage 
return (CR) or ALT MODE characters. These lines can be read into a 
buffer, selectively examined, moved, deleted, or modified, and writ 
ten out. New text may be substituted, inserted. _or aDDendarl^ 


me programs editvp and EDITVT are similar to EDIT except that they 
permit text to be displayed on the VP15A Graphic Display and VT15 
(CRT) . Refer to the EDIT Utility Program Manual (DEC-15-YWZB-DN6 ) . 

2.11 PERIPHERAL INTERCHANGE PROGRAM (£> IP) 

PIP can transfer data files from any input device to any output 
device. It can be used to 

(1) refresh file directories, 

(2) list file directory contents, 

(3) delete, insert, segment, or combine files, 

(4) perform code conversions, 

(5) assign protection codes, 

(6) transfer files, or 

(7) copy the entire contents of disk and DECtape storage units 

It may also be used to update and allocate restricted disk storage 
surfaces. Refer to the PIP (DOS Monitor) Utility Manual 
(DEC-15-YWZB-DN13 ) . 
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2.12 DECTAPE COPY (DTCOPY) 

This program permits high speed copying of DECtape to DECtape units. 
The advantage of DECtape Copy over the PIP copy function is that DEC- 
tape Copy is faster. For more information concerning this utility 
program, refer to the Keyboard Command Guide (DEC-15-NGKA-D) . 

2.13 LIBRARY UPDATE PROGRAM 

This system program gives the user the capability to examine, extract, 
and update the binary library files on mass storage devices. For more 
information, refer to the UPDATE Util ity Program Manual 
(DEC-15-YWZB-DN7) . 

2.14 SOURCE COMPARE PROGRAM (SRCCOM) 

The SRCCOM program compares any two symbolic source programs (ASCII) 
and indicates their differences. This program is useful for program 
identification and/or verification, proofing an edited program, com- 
parison of old and new versions of the same program, etc. For more 
information, refer to the SRCCOM Utility Program Manual 
(DEC-15-YWZB-DN11) . 

2.15 GRAPHIC-15 

Within this stand-alone system, VT-15 Graphics Software programs are 
used to compile display commands, define display elements, and direct 
linking, displaying and deleting of the elements necessary for a DOS 
resident graphics run-time system. Subprograms provided include: sub- 
picture routines, main display file routines, input routines, relocat- 
ing routines, and system I/O device handlers resident in the DOS I/O 
Service (IOS) directory. For more information refer to the GRAPHIC15 
Programming Manual (DEC-15-ZFSA-D) . 

2.16 PDP-8 TO PDP-15 TRANSLATOR ( 8TRAN ) 

This program is used as an aid in translating programs written in the 
assembly languages of the Digital PDP-8 computer (PAL III, MACRO-8) 
into MACRO-15 form. The translator does not produce an executable 
prc^ram, but translates a major portion of the PDP-8 code into equi- 
valent MACRO-15 code and indicates those areas of the 8 program which 
must be reviewed and processed by the programmer. For more informa- 
tion see the PDP-15 8 -TRAN Manual (DEC-15-ENZA-D) . 


2-11 



2.17 PDP-8 TO PDP-9 TRANSLATOR (89TRAN) 


The PDP-8/PDP-9 Translator ' is used to translate programs written for 
PDP-8 in PAL III or MACRO- 8 assembly language to MACRO-9 assembly 
language. This translator is available as a DOS system program for 
a user installation consisting of several DEC computers including a 
PDP-8, a PDP-9 , and a PDP-15. For detailed information concerning 
this program, refer to the 8TRAN Manual, DEC-09-ENZA-D . 


2.18 VP15A GRAPHICS SOFTWARE 


The VP15A Graphics Software package consists of a group of routines 
which can be used with either FORTRAN IV or MACRO-15 programs to 
operate the VP15A Storage Tube Display. Included in the package 
are an I/O device handler, text, point-plotting, and other routines, 
all described in the VP15A Graphics Software Manual (DEC-15-UXSA-D) . 
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CHAPTER 3 


SYSTEM CONCEPTS 


3.1 DOS-15 MONITORING FUNCTIONS 

There are three sections to the DOS-15 Monitor: (1) the Resident 
Monitor, (2) the Nonresident Monitor, and (3) the System Loader. 

The Resident Monitor remains in core when system or user programs 
are running, and acts as the interface between the program 
and the system's facilities. During program operation, the Resident 
Monitor has general control over the system. It functions to: 

1. Maintain orderly program flow, 

2. Handle teleprinter I/O, 

3. Act on Monitor calls, 

4. Validate and transmit I/O calls to device handlers, 

5. Announce error diagnostics. 

The operator may alter the structure of the Resident Monitor via 
commands to the Nonresident Monitor. The Nonresident Monitor allows 
the operator to interrogate and alter many key parts of the system, 
in order to set up the system for the next program. It functions to: 

1. Set I/O conditions by assigning physical devices to 
logical unit numbers, 

2. Supply system information, 

3. Save or restore core images, 

4. Load and Execute system and user programs, 

5. Change default system parameters. 

Normally, at the end of a particular program, the operator, the Batch- 
ing Command String, or the program itself returns control to the Non- 
resident Monitor. At that point, the operator or the Batching Command 
String sets up the system for the next program and calls it in via 
commands to the Nonresident Monitor. 

The System Loader ( . SYSLD) builds the Resident Monitor according to 
prior commands to the Nonresident Monitor. It loads (a) all core- 
image system programs and all handlers for those system programs, 
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(b) the Linking Loader or (c) EXECUTE. In almost all cases, a change 
of program involves actions by the System Loader. The System Loader, 
however, is completely invisible to the user except for LOAD errors, 
such as insufficient core. 


The DOS-15 Software System provides an interface between the system 
or user-created program and the external world of I/O devices. This 
simplifies I/O programming. This interface is comprised of a function- 
ally related group of software called the Input/Output Programming Sys 


(1) the I/O device handling routines within DOS-15, 

(2) a portion of the Monitor which is used in dis- 
patching I/O commands to them, and 

(3) a Monitor routine for printing error messages. 

I/O device handlers are provided for all standard devices (see Chapter 
9) . These handlers relieve the user of the burden of I/O service, 
file management, overlapping I/O considerations and unwanted device 
dependence. I/O commands and data modes are standardized and are 
recognized by DOS-15 device handlers. This facilitates device independ- 
ence. For example; a non-file structured device handler such as the 
paper tape reader will ignore (rather than declare an error) a command 
to "seek a file" (which is required for file structured devices prior 
to issuing commands to read) . There are other features of the system 
which contribute to device independence; they are discussed in later 
paragraphs . 


3.1.1 System Communication Table (SCOM) 


The System Communication Table (SCOM) is a set of registers that are 
referenced by the Monitor, I/O device handlers, and other system pro- 
grams. It acts as a common parameter area for information required by 
both the System Loader and Monitor. User programs may also utilize 
the information in this table as desired. The System Communication 
Table begins at absolute location 100g (Bank 0 ) . 

The following list briefly outlines some of the SCOM table functions; 

Free Core Limits 
Option Availability 

System and User Program Start Addresses 
Handlers 
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Interrupt Levels 
Magtape Status Register 
Number of Buffers Allocated 
Number of Words/Buffer 

Number of Entries in Mass Storage Busy Table 
User Identification Code 
Software Control Switches 
Date (MMDDYY ) 

Time (HHMMSS ) and other Clock Information 
Default Protection Code for Files 

A complete list of the SCOM table functions is given in the DOS System 
Manual (DEC-15-NRDA-D) . 

3.1.2 Monitor/User Interaction 

The console teleprinter is the primary user-system interface for 
DOS-15 program control. This control is implemented by commands to 
the Monitor, which accepts the three types described below: 

1. Commands which perform special services 

2. Commands which load system programs 

3. Control character commands which provide system 
control while running user or system programs. 

NOTE 

In the context of this manual, the term "console 
keyboard" designates any one of several keyboard/ 
printer/display I/O devices which could be used 
by the Monitor as the system command console de- 
vice (generally, a Model 33 or 35 teleprinter). 

The operator at the keyboard types commands to allocate system re- 
sources, load and start System and user programs, terminate program 
operation, and exchange information with the Monitor. Most of the 
Monitor's keyboard commands are issued prior to loading programs and 
are interpreted by the Nonresident Monitor, since it is not resident 
in core during system or user program execution. During program exe- 
cution, a small set of keyboard commands is available for general 
program control. These commands are interpreted by the teleprinter’s 
I/O device handler (which is part of the resident portion of the 
Monitor), and are used to control program start and restart, dumping 
of core, and the reloading of the Nonresident Monitor. Details on 
the DOS-15 commands which can be issued from the console keyboard are 
described in Chapter 8. 
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The keyboard commands are, however, not strictly limited to input from 
the .key hoard-*. — .The Mcnitor carr-t s- opcrabeuri rr 'a ^Comma nd Bat enina Mode 
in which keyboard commands can be issued either from punched cards or 
paper tape with minimum operator intervention. Similarly, the Monitor's 
responses to commands are not strictly limited to a keyboard device's 
printer or display, but may also be output to other devices including 
the VT15 Display or a line printer, when available. 

3.2 I/O COMMUNICATION 

The Monitor, by means of Device Handlers and Priority Interrupt (PI) 
or optional Automatic Interrupt (API) , permits simultaneous operation 
of I/O devices along with overlapping computations. 

A system or user program initiates an I/O function by means of a 
Monitor command (system macro) , which is interpreted within the 
Monitor as a legitimate I/O call. The I/O call includes a logical 
I/O device number as one of its arguments. The Monitor establishes 
the logical/physical I/O device association by means of a special 
table. When this has been accomplished, the Monitor passes control 
to the appropriate device handler to initiate the I/O function, 
after which control is returned to the system or user program. _ 

The system or user program retains control until an interrupt (PI or 
API) occurs; at this time the device handler takes control, in order 
to perform and/or complete the specified I/O function. The program 
may continue computation or other processing while waiting for 
I/O completion. This feature allows the programmer to make optimum 
use of available time. 

3.2.1 Device Independence 

In the DOS Monitor environment, the system manager may set up default 
device associations (correspondence between logical/physical devices) 
during system generation. Just prior to loading a system or user 
program, a user may change these associations via the ASSIGN keyboard 
command. This capability adds true device independence to DOS-15. 

All device handlers are nonresident in the sense that only those handlers 
required by a program are loaded into core. 
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3.2.2 I/O Device Handlers 


Users are spared the task of writing system software to handle input/ 
output to all standard system peripherals, since appropriate routines 
(Device Handlers) are supplied with the DOS Monitor. These routines 
process file and data level commands to the peripheral device. They 
generally perform the following functions: 

1. Drive I/O devices, 

2. Block Data Records for Devices, if necessary 

3. Manipulate files, 

4. Optimize device timing, 

5. Allocate/Deallocate Storage Space on the device, 

6. Request/Return core space. 

All communication between user programs and I/O device handlers is 
made via I/O Macros. Macros are covered in Chapters 5 and 6. 

There may be available in the system several handler versions for a 
particular device (e.g., DKA , DKB , DKC) . Each represents different 
compromises between core use and handler flexibility. Device handlers 
are covered in depth in Chapter 9. 

3.2.3 Device Assignment Table (.DAT) 

The DOS Monitor contains a Device Assignment Table (.DAT) , with an en- 
try for each device used. Since the contents of the table can be al- 
tered by commands to the Monitor , actual I/O devices may be changed 
without altering the program references (logical device units) to these 
devices. Refer to Chapter 4 for more information concerning .DAT. 

3 . 3 FILE STRUCTURES 

A file structure, as defined for DOS-15, is a method of recording, link- 
ing and cataloging data files. Each peripheral device has an associ- 
ated file structure which governs the manner in which data are stored. 

Card files and paper tape files are always organized as sequen- 
tial files and both files and records are processed sequentially. 

A file or record in the middle of the medium can only be accessed 
after all preceding items have been processed. This is a restric- 
tion which is a consequence of the nature of the storage medium. 

In contrast, DOS-15 provides direct access to files stored on 
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DECtape or disk. The system maintains directories on these devices 
that point to each file on the device. Hence, such devices are called 
"directoried" or "file-oriented". Both DECtape and Magnetic tape 
(Magtape) permit the user to operate either in a directoried or a 
non-director ied (sequential) mode. The system maintains a mini- 
directory for each file which points to each physical block in the file. 

The user of the PDP-15 Disk Operating System is not required to pre- 
allocate file storage; the operating system provides the file storage 
space dynamically on demand. Not only is this convenient for the user 
because he does not have to worry about allocation when he is creating 
files, but it conserves storage by preventing large portions of storage 
from being unnecessarily tied up. More information on this topic can 
be found in Chapter 4. 

3.3.1 User File Directories and UIC's 

On DECtape, there is only one directory for the whole tape. On disk, 
there is a central directory, called the Master File Directory (MFD), 
but each user can have his own User File Directory (UFD) . The MFD 
points to each UFD. Each UFD is named by a unique three character 
User Identification Code (UIC) . The User File Directory Table ( .UFDT) 
is part of the Resident Monitor associated with the Device Assignment 
Table. It indicates the User Identification Code (UIC) associated with 
every .DAT slot (i.e. , each logical device) . Disk I/O to a particular 
.DAT slot will go to files in the UFD named by the corresponding .UFDT 
slot. 

The Monitor finds User File Directories by seeking associated User 
Identification Codes (UIC's), which are all listed in the Master File 
Directory. The UIC is necessary for all directory-oriented I/O to the 
disk. A programmer may identify himself (LOGIN) to the system with 
only one UIC at a time, but he may have as many UIC's as he wishes, 
provided each is unique and none is reserved 1 . Further, programs may 
simultaneously reference files under several different UIC's. 

3.3.2 Monitor Identification Code (MIC) 

A three-character Monitor Identification Code (MIC) is established at 
system generation time to provide privileged access by the System Man- 
ager. When the System Manager uses the MIC, all system and user files 
are open for reference or change. This code acts as a key to temporar- 
ily remove file protection. System generation, modification of system 

‘The LOGIN keyboard command is described in Chapter 8. 
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programs and listings of the entire disk directory are allowed only 
under the Monitor Identification Code. 

3.4 FILE PROTECTION 

DOS-15 offers a simplified form of file protection. Each User File 
Directory has a protection code (optionally specified in commands to 
PIP) , and each file has a protection code (optionally specified in 
the .ENTER command or a command to PIP) . The protection codes are 
in effect only when a user tries to reference a file listed under a 
UIC other than the one currently logged in to the system. If a 
User File Directory is protected, then the protection is provided for 
any file in the directory. For more information, refer to Chapter 6. 

The default protection code for the files is established at system 
generation time. Users may temporarily change the file default pro- 
tection code via the PROTECT command to the Monitor. (See Chapter 8.) 

3.5 I/O BUFFERS 

Two Monitor commands allow any handler or user program to call the 
Monitor to allocate and deallocate buffers. Each buffer is obtained 
from a "buffer pool" as needed. For more information, refer to 
Chapter 6 . 

3.6 CHOICE OF EXECUTABLE FORM 

The object code usually produced by FORTRAN IV and MACRO-15 is re- 
locatable binary which is made absolute by CHAIN, or loaded at run 
time by the Linking Loader. In addition to relocatable output, the 
MACRO-15 user may specify non-relocatable types of output code. 

3.6.1 Relocatable Binary 

A relocatable object program may be loaded into any part of memory, 
regardless of which locations are assigned at assembly or compile 
time. To accomplish this, the address portion of some instructions 
must have a relocation constant added to it. This relocation constant 
is added during segmentation, by CHAIN, or at load time by the Link- 
ing Loader. It is equal to the difference between the actual memory 
location that an instruction is loaded into and the location that 
was assigned to it at assembly time. The language processors use 
codes to identify storage words as relocatable, absolute, or external. 
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Relocatable Binary object programs may be placed into and executed 
from any part of memory, regardless of the core locations assigned to 
the instructions by the language translator. The primary advantage 
of such a system is that it enables the user to easily write and load 
into core memory many programs (e.g., the main program and several 
subroutines) with no necessity for prior core mapping. Relocatable 
Binary is always produced by FORTRAN and is produced MACRO-15 when 
there are no .ABS or .FULL pseudo-ops. 

3.6.2 Absolute Binary Forms 

Absolute Binary object code is produced using the MACRO Assembler's 
.ABS, . ABSP , .FULL, or . FULLP pseudo-ops as described below. Programs 
assembled with these pseudo-ops are loaded and executed independently 
of the DOS-15 System software. Refer to the MACRO Assembler Manual 
(DEC-15-AMZC-D) for more information. 

3. 6. 2.1 .ABS and .ABSP Binary - The .ABS and .ABSP binary forms are 
checksummed binary coded programs or instructions assembled as .ABS 
(Absolute Binary) and assigned to occupy specific or absolute loca- 
tions in core memory. These programs can only be loaded into or 
executed from the locations assigned by the language translator. 

The task of placing multiple routines into core for execution becomes 
a tedious one. Absolute binary does have the advantage of a smaller 
loader, thus enabling the user to execute a larger program than is 
possible using relocatable binary. Ordinarily, the Assembler will 
precede the output with an Absolute Binary Loader which will load 
the punched output at object time. The loader is itself loaded via 
Hardware Read-in Mode. 

3. 6. 2. 2 .FULL and .FULLP Binary - The .FULL and .FULLP binary forms 
are unchecksummed binary consisting solely of 18-bit storage words. 
Programs assembled in this form are output on paper tape and are 
loaded via Hardware Read-in Mode. 

3.7 LOADER CONTROL 


As indicated in the previous section, CHAIN and the Linking Loader 
make relocatable object programs absolutely addressed. In addition, 
they join relocatable programs by supplying definitions for global 
symbols which are referenced in one program and defined in another. 
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3.7.1 Globals 


The global feature is another of the programmer conveniences provided 
by the MACRO-15 Assembler. It allows the user to provide a symbolic 
linkage between separately assembled programs including: a main pro- 
gram, subprograms, and general subroutines in system (Bank or Page) 
Libraries or User Libraries. 

In MACRO, the pseudo-op .GLOBL, followed by a list of symbols, is used 
to define to the Assembler two types of global symbols: 

1. Internal Globals - defined in the current program 
and referenced by other programs. 

2. External Symbols - referenced in the current pro- 
gram and defined in another program. Each external 
symbol will be used by the Linking Loader or CHAIN 
to store the actual address. All references to ex- 
ternal symbols should be indirect references, as 
memory banks may have to be crossed. 

The FORTRAN equivalents to external and internal . GLOBL ' s are CALL and 
SUBROUTINE. The Linking Loader and CHAIN use this information to re- 
locate and then link the programs to each other. 

3.7.2 Program Loading 

At program load time, the user, via appropriate keyboard commands, can 
select either Page or Bank Mode program loading and execution. Two 
versions of the Linking Loader and System Library are provided - one for 
each mode. 


3. 7. 2.1 Page Mode Operation - The DOS Monitor Page Mode System 
loads and relocates user programs in 4K pages and permits address 
modification via the index register (Index Addressing) . In Page 
Mode, the loader obtains library routines from the library in the 
PAG System file directory. The Page Mode System is supplied as 
standard software with PDP-15 systems. 

3.7. 2. 2 Bank Mode Operation - The optional Bank Mode system permits 
direct accesing within 8K banks, but does not permit the use of the 
index register for address modification. This system is useful to 
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the PDP-15 user who prefers direct addressing up to 8K, or who wishes 
to take advantage of the extensive library of PDP-9 programs available 
from the Digital Equipment Computer User's Society (DECUS ) . All 
core-image system programs run in Bank Mode. In Bank Mode, the 
loader obtains library routines from the library in the BNK System 
file directory. 

3.8 ERROR DETECTION 

Comprehensive error checking and recovery are provided by the DOS-15 
Monitor, the loaders, and the I/O system as follows: 

a. DOS-15 Monitor Errors - error conditions related to 
system devices, illegal device assignment, program 
name, and command references. 

b. Linking and System Loader errors - memory overflow, 
input data errors, unresolved globals, and illegal 
.DAT Slot requests. 

c. IOPS Errors - all Input/Output device and data errors. 

Detailed lists of errors that occur in the latter two categories can 
be found in Appendices D and E, respectively. The Monitor Errors, when 
they occur, are easily understood and recovery will be self-evident. 

The automatic core-dump commands QDUMP or CTRL Q will condition the 
Monitor to dump memory on the "save" or "CTRL Q" area of one of the 
units of the system device, in the event of an unrecoverable error. 

Terminal errors are not reported to the user's operating programs; 
there are, however, a few I/O-detected errors that are reported to the 
user for program use, e.g., parity, checksum, and buffer overflow errors 
are indicated in special control words of each IOPS data record (see 
Chapter 6) . Error detection and recovery are discussed in Chapter 10. 

After error messages are output, the user may optionally restart the 
program (CTRL P) , dump core (CTRL Q) , or return control to the Non- 
resident Monitor (CTRL C) . Other options are available to the user 
when errors occur; these will be discussed in succeeding chapters of 
this manual. 
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CHAPTER 4 


FILE STRUCTURES 


4.1 INTRODUCTION 

This chapter will define those concepts and facilities of the DOS-15 
system that are available for storage and retrieval of data from PDP-15 
mass-storage hardware/software systems, including DECdisk (RF) , Disk 
Pack (RP) , Magtape (MT) , and DECtape (DT) . 

A large part of any programming task is accepting input and producing 
output. Therefore, it is necessary to understand the Input/Output 
process to take full advantage of the Disk Operating System’s features. 

4.2 DEVICE ASSIGNMENTS 

As stated in the previous chapter, device assignment is managed through 
the Monitor's Device Assignment Table (.DAT). The .DAT associates 
logical device units with physical ones through "slot" numbers, which 
correspond to the logical device numbers. 

Device assignment slots are assignable via the Monitor ASSIGN command 
at run time. Refer to Section 8.5 of Chapter 8 for more information. 
Default assignments are defined during system generation (see SGEN 
Utility Program Manual (DEC-YWZB-DNlp) . Information in each program 
indicates which "slots" are required for that program. These slots 
are called the "active slots". The loaders use the information about 
active slots to bring in handlers for the devices named by the active 
slots. At run time, then, each slot contains the physical device unit 
number (if any) , and a pointer to the appropriate device handler, which 
was brought in by the loader. Without device assignment on a .DAT 
slot, a program's call to that slot will result in an I/O error — the 
slot will not point to a handler. Depending on the system generation, 
as many as seventy-three entries may be in the .DAT for program device 
assignment. 

Each I/O command under DOS-15 references a .DAT slot. These commands 
pass control to the appropriate device handlers via a Monitor routine 
that uses the pointers in the .DAT. These device handlers are 
responsible for transferring data between the program and I/O devices. 
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They also initiate the physical reading or writing of files and perform 
opening and closing of files and other functions peculiar to a given 
hardware device. Each slot then links the device-driving functions 
within a specified device handler to the program. The handlers all test 
for functions which they cannot service; for example, trying to rewind 
a card reader. Some functions are ignored; others are illegal and 
cause error messages to be output to the console teleprinter. All de- 
vice handlers operate either with or without the Automatic Priority 
Interrupt (API) option. 

4.3 FILES 

A file is a collection of related records treated as a unit. In 
Inventory Control, for example, one line of an invoice forms an item, 
a complete invoice forms a record, and the complete set of such 
records forms a file. The word "file" is used in the general sense 
to mean any collection of infonnaH nn i feme c -im-Mar- ^ 

purpose, form and content. "File" may also be generally applied to 
external storage media such as papertape, punched cards, a Magtape, 
a DECtape, DECdisk platters, and a Disk Pack. 

4.3.1 Records 

In DOS-15, a record is a set of one or more related data words acces- 
sible to the user as one item through .READ and .WRITE MACRO program 
statements or FORTRAN language statements. (Chapter 6 describes .READ 
and .WRITE) . The smallest addressable logical item within the file 
is this logical record. 

4.3.2 Words 

A word is the least addressable physical data unit and is the informa- 
tion vehicle for Buffer Header and Data Modes. 

I/O Buffers are internal to, and must be defined by, each program. 

With the exception of certain block transfers, a buffer contains a 
single record. Under most of the Data Modes (described below) , the 
first two words in an I/O buffer (i.e. , a record) provide system in- 
formation and cannot be used for data. This Header Word Pair with- 
in an I/O buffer is detailed in Chapter 6. On blocked devices 
(Disk and DECtape) , these header word pairs govern the physical 
structure within the file. Before output, the user must set up the 
Header Word Pair. On input, the Header Word Pair arrives with Data 
Mode Information and certain error indicators. The user is 
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responsible for checking the various header parameters to determine if 
the data was read without error. 

4.3.3 Data Modes 

The Monitor allows data transmission to or from a system or user pro- 
gram in several different modes which structure internal data storage. 
Two modes, IOPS ASCII and IOPS Binary, offer the advantages of device 
independence. All handlers accept IOPS ASCII data, and most accept 
IOPS Binary. Three other data modes. Dump, Image Alphanumeric and 
Image Binary, allow the user to take advantage of device dependent 
characteristics. For more information, refer to Chapter 6. 

4.4 FILE STRUCTURES 


As stated in Chapter 3, a file structure is a method of recording, 
linking, and cataloging data files. File structuring, in general, is 
applicable to all I/O device, including cards, paper tape, printers, 
keyboards, etc. In DOS-15, however, file structures are associated 
with Mass Storage devices only. A file structure dictates the file 
and record access methods. This organizational structuring is import- 
ant because a file can be effective for a user application only if it 
is designated to meet specific requirements. A user must consider 
the following factors: 


SIZE 

ACTIVITY 


VOLATILITY 


Growth of the file may require a change 
in file structure or data mode. 

The need to access many different records 
within a file (percentage of activity) or 
to frequently access the same records (an 
active file) will influence information 
retrieval efficiency. This requires the 
user to select the right method for each 
job task. 

The number of additions and deletions to 
a file will affect the efficiency of the 
structures used. 
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4.4.1 File and Data Access Techniques 


The usual technique for applications using Magtape is sequential ac- 
cess to the data file and sequential access of the data records. 

This access is also characteristic of most uni-directional media, 
such as cards, paper tape, keyboards, printers, and displays. 

Another technique, which in DOS-15 is applicable only to the disks, 
involves • random-access (an alternate term is "direct-access") to a 
file and random-access of data records within the file. 

A third and intermediate technique, which is normally used on DECtape 
and on disk, employs random-access to a file and sequential access to 
the file's data records. The formal term is "random-sequential file 
structure"; the informal term is "DECtape file structure". 

4.4.2 Sequential Access 

Sequential access is a storage retrieval technique in which a file 
and the records within it must be retrieved in the sequence in which 
they physically occur. Sequential access, when applied to the 
process of locating the beginning of a file or a data record within 
the file, means that the time required for such access is dependent 
on the necessity for waiting while non-desired files or records are 
processed in turn. 

1. Records can only be retrieved sequentially, beginning 
with the first record and accessing each subsequent 
record in turn. 

2. Direct retrieval is not possible, since no directory 
exists to the physical locations of the records. 

3. Additions and deletions are only accomplished by 
copying the entire file. 

4.4.3 Direct Access 

Direct access to a file or to a data record within the file means 
that the time required for such access is independent of the location 
of the file or record relative to other files or records. 

Direct access should be considered as a valuable access method when 
retrieving selected records from random files; but it is not suited 
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for sequential retrieval of records. The direct access technique 
makes it possible to process only the affected record during a file 
update. This reduces data sorting. 

The main advantage of direct access processing is that it requires 
fewer processing steps. Along with its advantages, however, a direct 
access application requires special consideratio ns by the system pro- 

iron backup on I 

tape system because the old record on a direct access device is 
destroyed when the updated record is written over it. 

4.5 MAGNETIC TAPE FILE STRUCTURE 

The DOS software provides for industry-compatible magnetic tape (Mag- 
tape) as either a directoried or a non-directoried medium. The 
magnetic tape handlers communicate with a single Tape Control Unit 
(TCU) with up to eight magnetic tape transports. 


When used as a non-directoried medium, there are a number of major dif- 
ferences between Magtape and other mass storage devices such as DECtape 
or Disk. Magtape is well suited for handling data records of variable 
length; such records, however, must be treated in serial fashion. The 
physical position of any record may be defined only in relation to the 
preceding record. 

When used as a directoried medium. Magtape assumes the external operat- 
ing characteristics of DECtape (described in 4.6). 


Sequential tape files are written one after the other, starting at the 
physical beginning of the tape. These files are separated from one 
another by End-of-File marks (hardware-detected) or by an End-of-Record 
line (software-detected). (Refer to Figure 4-1, Sequential Data Access.) 
To read the N th file on a tape, the user must first rewind to the begin- 
ning of the tape and then skip serially through N-l files to the desired 
file. Sequential tape files need not have a filename, only a known 
position relative to the files on the tape. 

Data records within a file are recorded in sequence. Sequential state- 
ments direct records to and from memory in the sequence in which they 
are physically on the device. To access the M t}l record within the N th 
file, the user first locates the beginning of the file (skipping N-l 
files) and then skips through M-l records. 
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Figure 4-1 Sequential Data Access 


This sequential access method does not need a tape-resident directory 
to point to files. It is, therefore, called "non-director ied" in DOS. 
The non-directoried access method is generally applicable to unit- 
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If magnetic tape transports could identify absolute positions on a 
tape, there would be no need to do sequential file access. The trans- 
port could search to a known location, and start processing. Then, 
an extra body of information (a directory) on the tape could point 
to each file. DECtape has this capability. 

In directoried mode, files are given unique names. The name and posi- 
tion of the beginning of a file are recorded in a directory. Direc- 
tories are at fixed location (Block 1 00 g ) on the tape. DECtape direc- 
tories point to the first block of each file and each block points to 
the next. DECtape directories also maintain bit maps which indicate 
which tape blocks each file occupies and a map to show all occupied 
blocks on the tape. The file directory is fixed in size; consequently, 
the number of files that may be recorded is limited by the amount of 
storage available on the device (HOOg blocks) and/or by the number 
of file name slots in the directory (56 maximum) . 
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Figure 4-2, Director ied Data Access 



Figure 4-3, Disk Data Access 
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File structures which employ a directory allow simpler and, in the long 
run, faster access to a file (the beginning of a file). See Figure 4-2. 
This is a distinct advantage over those devices which do not use a 
directory and must therefore rely on a file's position relative to 
other files in order to locate it. 

Programmers need not use the directory capabilities of DECtape. They 
can treat DECtape as magnetic tape by issuing magnetic tape I/O com- 
mands. Then no directory or identifying information of any kind is 
recorded or referenced on the tape and operation is similar to that 
of magnetic tape (described in 4.5). The DECtape handlers with their 
respective I/O functions allow the use of either of thse modes. 

4.7 DISK FILE STRUCTURE 

The DOS-15 disk file structure is in some ways analogous to DECtape 
file structure. Ordinarily, each disk user has a directory which 
nnints to nampH f i log /ne t- npc> -- - 1 ~ ^ ~ .— i f- u xT^q-f C - ~ 
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The DECtape, however, has only one directory, but the disk has as many 
directories as users have cared to establish. Whereas DECtape direc- 
tories may reference only a maximum of 56 ^q files, the number of files 
associated with any one directory on the disk is limited only by the 
available disk space. A single disk file's size is also limited by 
the available space, as is true with DECtape. 

The DECtape directory is in a known location ... at block 100 . Since the 
disk may have a variable .number of directories, the Monitor must know 
how to find each user's directory. It, therefore, maintains a Master 
File Directory (MFD) at a known location, and the Master File Directory 
points to each User File Directory (UFD) . DOS-15 allows only those 
users who know a special code, called the Monitor Identification Code 
(MIC), to have access to the MFD. Figure 4-3, Disk Data Access, 
illustrates the organization of the disk. 


4.7.1 User Identification Codes (UIC) 

The Monitor finds User File Directories by seeking associated User 
Identification Codes (UIC's) which are all listed in the Master File 
Directory. The UIC is a three-character code that is necessary for 
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all directory-oriented I/O to the disk. A programmer may establish 
a new User File Directory by: 

\J \ >' r< tr 

1. Logging in his new UIC to the Monitor, 

2. Calling PIP, 

3. Issuing an "Ni_iDK^" command. 

This establishes a new User File Directory, or refreshes (wipes clean) 
an old directory under that UIC. The "enter file" I/O command will 
also create a UFD , if none exists. 


4.7.2 The User File Directory Table ( .UFDT) 

The Monitor must have a way of knowing which User File Directory to 
reference when a program issues I/O commands to the disk. It makes 
the association between disk I/O commands and User File Directories 
by using a User File Directory Table (.UFDT). There are as many 
entries in the User File Directory Table as there are slots in the 
Device Assignment Table. Figure 4-4, Relationship Between the .DAT 
and the .UFDT, shows how the two compare. Disk I/O to a particular 
•DAT slot will affect files in the User File Directory named in the 
corresponding .UFDT slot. Programmers may modify .UFDT slots before 
loading a program, and programs themselves may alter .UFDT. 

4.7.3 File Protection 

DOS-15 offers a simple form of file protection. Each User File 
Directory has a protection code and each file has a protection code. 
The protection codes only protect a programmer's files from other 
users - not from himself. If a User File Directory is protected, 
then the protection codes for each file are in effect. If the user 
File Directory has been specified as unprotected, then no protection 
is provided for any file in the directory. There are three protec- 
tion states possible for files in a protected User File Directory. 

File Protection Codes : 

1 = Unprotected, with the exception that the file 

may not be deleted and the number of blocks may 
not change, if the directory is protected. 

2 = Write protected, if directory protected. 

3 = Read/Write protected, if directory protected. 
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. DAT/ . UFDT Number 


•DAT Contents 


.UFDT Contents 


Comment 


+N 

nondisk handler 

y ic i 

This UIC is ir- 
relevant 

+ 2 

disk handler 

UICj^ 

I/O to this slot 
will go to files 
in UIC^ 

+ 1 

disk handler 

UIC 2 

I/O to this slot 
will go to files 




in UIC 2 

-15 

none assigned 

UIC 1 

This UIC is ir- 
relevant 


The operator has logged in under Ult^. He has assigned some nondisk 
handler to .DAT+N, the DECdisk to .j)AT+2, and the Disk Pack unit 0 to 
. DAT+1 , and NON (no handler) to .DAT -15. In addition, he has changed 
the .UFDT assignment for .UFDT+1 to UIC 2 . I/O to .DAT+N will not 

reference the UIC, since UIC ' s are relevant only to disk I/O. I/O to 

! 

.DAT+2 will reference UIC^, while 1^0 to .DAT+1 will reference UIC 2 . 
The UIC for .DAT -15 is irrelevant, i since no handler is assigned. 


Figure 4-4 

Relationship Between the .DAT and the .UFDT 
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User File Directories may have one of two protection states: 

File Directory Protection Codes 

0 = Unprotected 

1 = Protected 

The default protection code for User File Directories is always 1, 
protected. The default protection code for files is established at 
system generation time. 

4.7.4 Organization of Specific Files on Disk 

The disk handlers write out files sequentially, just as the DECtape 
handlers do. On the close of an output file, the disk handlers also 
fill out a Retrieval Information Block (RIB) . The RIB performs the 
same functions as the file bitmap on DECtape, and associates the 
logical sequence of blocks in the file with the physical locations of 
the blocks on the disk. The disk handlers use the RIB to implement 
random access and to delete files. 

After a user has created a disk file, he can access records sequentially 
as with DECtape files. He can also read and write physical blocks of 
that file by referencing relative block numbers. The user is prohibited, 
however, from changing the total number of blocks in the file. 


4.7.5 The Disk Handlers 

The disk handlers allow as many concurrently open input or output 
files as there are .DAT slots available to the user, and buffers 
available to the disk handler. The disk handlers operate under a 
dynamic buffer allocation scheme. Whenever the Monitor loads a sys- 
tem or user program, it allocates buffer space. This space is called 
the buffer pool. Whenever a program opens a disk file, the handler 
obtains a buffer from the buffer pool. The handlers return the 
buffer when the program closes the file. 

The buffers in the buffer pool are available to programs, as well as 
to disk handlers. Whenever a program is using a buffer, however, it 
is unavailable to any other program. 
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CHAPTER 5 


DOS SYSTEM MACROS 


5.1 INTRODUCTION 

This chapter contains detailed reference information concerning DOS-15 
System Macros. I/O Macros (those which have a .DAT slot number as one 
argument) are discussed in Chapter 6. 

5.2 MONITOR-PROCESSED COMMANDS 

The MACRO-15 assembler permits the use of higher-level system instruc- 
tions called "System Macros" which, when used as a source statement, 
can cause a specific sequence of Monitor operations to occur at run- 
time . 

These System Macros are referenced (called) in user programs by writing 
a statement consisting of a System Macro name followed, if needed, by 
a tab, space or spaces, plus a list of arguments separated by commas. 
Macro statements are terminated by either a space or spaces (,__,) , a 
tab ( -*|) , or a carriage return (_J ) . Fnr pvamnlaj 

.TIMER -A 5fS0fS ,TmOUTj 

5.2.1 Summary of DOS Monitor System Macros 

Table 5-1, Summary of System Macros, summarizes the non-I/O macros 
which the Monitor implements. The following paragraphs describe the 
individual system macros in detail. 


Table 5-1 Summary of System Macros 


Name 

Descri£tion 

.EXIT 

Requests the System Loader to bring in the Nonresident 
Monitor . 

.GET 

Overlays core with the contents of a named file. 

.GTBUF 

Requests a buffer from the buffer pool. 

. GVBUF 

Returns a buffer to the buffer pool. 

. OVRLA 

Requests the System Loader to load the named core-image 
program. 

.PUT 

Creates a file containing the current core image. 

. TIMER 

Initializes a time interval after which program control 
passes to a user specified subroutine. 
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5.2.2 DOS-15 System Macro Expansions 


The following standards apply to the descriptions of the System and I/O 
Macros presented in this chapter and in Chapter 6: 


A. Format Conventions 


1. Upper case terminology must be used as stated in the 
FORMAT Description. 

2. Lower case terminology indicates user-supplied information, 
as defined by ARGUMENTS. 

3. Names for user-supplied parameters indicate maximum length 
of field by the number of characters in the name. Thus, 
"namptr" may be a maximum of six character long, and 
"num" may be a maximum of three characters. 

4. Brackets ([ ]) indicate optional quantities. 

5. A bracket on its side (u) indicates a space. 

6. Quantities listed vertically and enclosed in braces ({ }) 
indicate the user must choose one from the group. 

7. The expansions indicate how one might write an expanded 
macro directly to the assembler. (Any fields in the macro 
designated as decimal radix must be octal radix when 
included in an expansion.) The expansions may appear 
different from expansions produced by the assembler. They 
are, however, functionally equivalent. 


B. Sixbit File Representation 


Many of the System and I/O Macros have a "namptr" argument which points 
to a 3-word block of core in the useir's program containing the Sixbit 
representation of a file name and extension. This is simply an 
abbreviated form of ASCII in which the rightmost 6 bits of the ASCII 
code are used. This allows 3 characters to be packed in one word of 
storage. Sixbit packing can be accomplished either by the user 
program or by the MACRO-15 Assembler's .SIXBT pseudo-op. (Refer to 
the MACRO-15 Assembler Manual (DEC-15-AMZB-D) . The example following 
paragraph 6.8.5 demonstrates the use of .SIXBT. 
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5, 2. 2.1 .PUT 


Creates a file which contains the current core image. 
The file's name and extension will be that found in 
the locations pointed to by namptr. See also .GET. 

MACRO-15 does not expand the .PUT Macro. The following 
FORMAT statement illustrates how the user might 
formulate his own macro. The Resident Monitor, how- 
ever, does recognize the command illustrated in the 
EXPANSION section. 

FORMATS 


. PUT i_jf , namptr , u 


ARGUMENTS: 


f = (function) determines the startup loca- 
tion for a .GET with f=4, 
or a GET Keyboard command 
to the Nonresident Monitor. 


f = 0 Subsequent load will start at the 
location following the EXPANSION. 

f * 1 Subsequent load will start at 
current CTRL P address 

f = 2 Subsequent load will start at 
current CTRL T address 

f = 3 Subsequent load will start at 
current CTRL S address 


namptr = pointer to the address of a 3-word, 

.SIXBT representation of the name 
and extension of the file to be cre- 
ated (unused spaces must contain nulls) . 

u = (unit) the unit number of the device as- 

sociated with .DAT-14 on which the 
desired file is to be placed. 


EXPANSION: 

LOC+0 CAL+f 
LOC+1 26 

LOC+2 u*100000+namptr 
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5. 2.2.2 .GET 


Overlays core with the contents of the file whose name 
is indicated by the Macro argument namptr. The file 
must have been created by a .PUT System Macro, or a PUT 
command to the Nonresident Monitor, and it must reside 
on the device associated with .DAT-14. .GET destroys 
the current contents of .SCOM, including DATE and TIME. 

See also the .PUT System Macro, and the PUT and GET 
commands to the Nonresident Monitor. 

MACRO-15 does not expand the .GET Macro. The following 
FORMAT statement illustrates how the user might formulate 
his own macro. The Resident Monitor, however, does recog- 
nize the command as illustrated in the EXPANSION section. 

FORMAT : 

. GETi_if , namptr , u 


ARGUMENTS : 


f = (function) - determines startup location 
after overlay. 


f - 1 

f = 2 

f = 3 
f = 4 


Start at location after 
expansion of System Macro 
that created the file. If 
file was created via a .PUT 
command to the Nonresident 
Monitor, load core from the 
file, and await a command 
from the console keyboard. 


Start at CTRL P 
address 

Start at CTRL T 
address 

Start at CTRL S 
address 


Refer to 
the DOS -15 
Reference 
Manual for 
more 

informa- 
tion . 


Start at the location speci- 
fied by the .PUT System Macro. 
If the file was created via a 
PUT call to the Nonresident 
Monitor, load core, and await 
command from the console key- 
board. 


namptr = Po inter to the first word nf a three- 

word . SI XBT representation of the file name 
and extension for the core image to be 
loaded. (Unused spaces must contain nulls.) 

u = (unit) The unit number of the device as- 

sociated with .DAT-14 on which the 
desired file is to be found. 

EXPANSION: 


LOC+0 CAL+f 
LOC+1 25 

LOC+2 u*100000+namptr 
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5. 2. 2. 3 . GTBUF (Get Buffer) 


Requests a buffer from the buffer pool. If a buffer is 
available from the pool, the Monitor will return the ad- 
dress of the first word of the buffer in the AC. If no 
buffer is available, the Resident Monitor will return 
777777 in the AC. On return, execution begins at LOC+3 . 
LOC+2 can be used as desired. This Macro gives user 
programs as well as handlers access to buffers. 

FORMAT: 


.GTBUF 


ARGUMENTS : 


none 

EXPANSION: 

LOC+0 CAL+0 
LOC+1 21 
LOC+2 0 


5. 2. 2. 4 . GVBUF (Give Buffer) 

Allows a user to return to the buffer pool a buffer 
obtained via a .GTBUF System Macro. 

FORMAT: 


• GVBUF 


ARGUMENTS: 


None, at assembly time, but 


AT RUN TIME, the program must load LOC+2 with 
the address of the buffer to be freed. If LOC+2 
does not contain the address of an allo- 
cated buffer, the AC will contain 777777 
on return. 


EXPANSION: 

LOC+0 CAL+0 
LOC+1 22 

LOC+2 0 (Load with first address of buffer) 
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5. 2. 2. 5 . OVRLA 


Requests the System Loader to bring and start the core 
image system program whose name is pointed to by the 
Macro argument namptr. If there is not enough room in 
core to load the program requested, the Resident Monitor 
will return control to LOC+3 . 


WARNING 

All I/O should be completed before 
issuing an .OVRLA. 


FORMAT: 



namptr - (name pointer) first address of the 

tWu -word .SIXBT repfesenta- 

tion of the name of the pro- 
gram co De nrougnt in. 

EXPANSION: 

LOC+JZ) CAL+0 
LOC+1 24 
LOC+2 namptr 


5. 2. 2. 6 .EXIT 


Requests the System Loader to bring in 
Monitor, Current contents of core are 
closed output files are destroyed, all 
closed. 


the Nonresident 
lost. All un- 
input files are 


FORMAT: 


• EXIT 


ARGUMENTS : 


none 


EXPANSION: 


LOC+0 CAL+ja 
LOC+1 15 
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5 . 2 . 2 . 7 .TIMER 


Allows programs to schedule routines to be called after 
specific time intervals. 


Refer to Chapter 2 of the DOS-15 System Manual 
( DEC-15-NRDA-D) for programming rules for 
these routines. 


FORMAT : 


. TIMERi_innnnnn , addres 


ARGUMENTS : 


nnnnnn * (time interval) number (in decimal 
radix) of clock ticks from "now" 
after which the subroutine is to be 
called 

ji < nnnnnn<_2* 8 -l 

addres = address of the routine to be called 
after the specified number of ticks. 


EXPANSION: 

LOC+0 CAL+0 
LOC+1 14 
LOC+2 -nnnnnn 
LOC+3 addres 
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CHAPTER 6 


PROGRAMMED I/O COMMANDS 


6.1 INTRODUCTION 

This chapter describes the concepts, commands and methods for incorpora- 
ting input/output commands in MACRO-15 assembly language programs. 

FOCAL and FORTRAN users need notf^'lii general, be concerned with the 
contents of this chapter, since each of these languages has its own 
I/O capability. 

The DOS-15 IOPS is the interface between any program and the external 
world of I/O devices. I/O device handlers are provided for all stan- 
dard devices and are described in Chapter 9. These handlers relieve the 
user of the burden of I/O considerations and unwanted device dependence. 

6.2 GENERAL I/O COMMUNICATIONS 

Under DOS-15, all I/O transfers and subsidiary I/O operations are 
initiated by programmed I/O commands called I/O Macros, as shown in 
Table 6-1. These I/O Macros are macro instructions which have a .DAT 
slot as one argument. As with System Macros, they are permanently 
defined in the MACRO-15 Assembler. 


As can be seen from Table 6-1, there are four I/O Macros within the 
DOS-15 Software System which effect data transfer: .READ, .WRITE, 

. RTRAN and .TRAN. The first three permit operation using the standard 
DOS file structures described in Chapter 4 and provide the most 
device independent approach to I/O programming. The .TRAN Macro func- 
tions independently of DOS-15 file structures. 
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Table 6-1 


SYNOPSIS OF DOS -15 I/O MACROS 



Function 

■ 

Initializes a directory on a directoried mass storage 
device. All data on the device is lost and fresh bit 
maps and directories are written. 

.CLOSE 1 

Terminates use of a file. In the case of output files on 
the disk, fills out the Retrieval Information Block (RIB) 
for later .RTRAN commands. 

. DLETE 1 

Deletes a file from a directory on a mass storage device. 

.ENTER 

Primes a directoried mass storage device to accept an out- 
put file. 

. FSTAT 

Checks the directory on a mass storage device for the 
existence of a named file. 

. INIT 1 

Initializes the device and device handler. 

.MTAPE 

Provides special commands for industry compatible magnetic 
tape. 

.RAND 

Opens a disk file for random orocessing via .RTRAN macros. 

• READ 

Transfers a logical record, or therequested number of words, 
whichever is smaller, from the device to the user's I/O 
buffer. 

. RENAM 1 

. RTRAN 

Renames a file in a directory of a mass storage device. 

Allows input and output to access any block in a pre- 
existent file on the disk (any word if RF) . 

-SEEK 

Checks for a named file in a directory on a mass storage de- 
vice. If the file is present, prepares it as an input file. 

.TRAN 

Gives independence from DOS-15 file structure by allowing 
input and output access to Magtape, or to any block on disk 
or DECtape located by its physical block number. A file 
can be opened for SEQ or random access and still be .TRANed 
via the same .DAT slot without destroying the file structure. 

.USER 

Allows programs to change the .UFDT. 

.WAIT 

Waits for I/O already started to complete, then continues. 

. WAITR 

Waits for I/O already started to comolete. then continues. 


If I/O not done, passes control to the specified address. 

.WRITE 

Transfers data from user's I/O buffer to the device. 

1 At completion of these operations , the buffer is given back to the 
buffer pool, if disk or DECtape "A" version handler I/O. 
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6.2.1 .READ/. WRITE/. RTRAN Operations 


•READ and .WRITE Macros permit the user to sequentially input and out- 
put records of a file consisting of ASCII lines or binary data to any 
device in the standard set of PDP-15 I/O devices. The .RTRAN Macro 
provides the user with random access to physical blocks when using 
the DECdisk and Disk Pack devices. Initially, files are created 
sequentially (.WRITE) and can subsequently be accessed both sequentially 
(.READ) and randomly (.RTRAN). 

6.2.2 • .TRAN Operations 

The last data transfer macro (.TRAN) functions only on mass storage de- 
vices. It provides I/O transfer capability at the device level with- 
out regard for established file structures. This type of transfer 
provides for user-designed file structuring. 

Much of the remainder of this chapter is devoted to I/O programming 
within the DOS-15 file structures and, specifically, to the methods 
and considerations involving the creation of sequential files. Little 
can be said here about the utilization of the .TRAN and .RTRAN Macros 
since the system places the burden of data structuring, interpretation, 
checking and packing on the programmer. 

6.3 SEQUENTIAL FILE PROCESSING 

I/O operations under DOS consist of the transfer of ASCII or binary 
logical records between buffer areas in the system or user program 
and I/O devices represented by the device handlers in IOPS. (A logical 
record is defined as the amount of ASCII or binary data which is trans- 
ferred to or from a program as the result of the execution of a single 
.WRITE or .READ I/O Macro.) The size of each logical record depends 
upon the structure of the data (Data Mode) and the device or set of 
devices addressed. The format and data structure of each logical 
record output in IOPS and Image Data Modes is described below. For 
Dump Mode, however, no particular requirements are placed on the user 
by the system. Dump mode is provided to permit user-created data 
structures within the DOS-15 file structure. 

6.3.1 Logical Record Format, IOPS and Image Modes 

Each logical record to be output in IOPS and Image Modes must be 
formatted as shown in Figure 6-1. The record, consisting of 2n 
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18-bit words contains a two word header (called header word pair) 
followed by 2n-2 words of ASCII or binary data. 


Word fl 

1st word of header 

"1 

header word 

Word 1 

2nd word of header 

J 

pair 

Word 2 


> 



2n-2 words of data 


\ ASCII 




or 

Word 2n 


J 

Binary 



Data 


Figure 6-1 IOPS and Image Mode Logical 
Records Format 


The header word pair is a communications link between the user's pro- 
gram and the I/O device handlers in IOPS. It is divided into various 
fields which contain information about the data which resides in the 
record. The information in some fields is supplied by the program to 
assist the device handlers in writing records and subsequently retriev- 
ing them. Other fields contain information which is provided by the 
device handlers for use by the user or system program when verifying 
records during input. Refer to paragraph 6.4.3 for explanation of Dump 
Mode record format. 

6. 3. 1.1 Header Word Pair Format - Figure 6-2 shows the format of the 
header word pair. Of particular significance is the Word Pair Count; 
it specifies the number of word pairs of data in each logical record. 

In addition, for all Data Modes except Dump Mode, it is the prime 
logical record terminating condition when using mass storage devices. 
This term should not be confused with the Word Count, which is an 
argument used in I/O Macros. The Word Count gives the actual size of 
the I/O buffer which contains the logical records prior to output and 
after input operations (see 6.7). 

6. 3. 1.2 Using the Header Word Pair 

* r>~ ^ z^--z J- — — 

The program must calculate and then set the appropriate word pair count 
in bits 1-8 of header word zero, unless they have already been set by 
a device handler on input (i.e., an input device handler set up the 
header word pair for each record read) . This count overrides the word 
count passed to IOPS by the .WRITE system Macro. The I/O mode field, 
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bits 14-17 , is set by the device handler from the I/O mode argument 
specified in the .WRITE Macro. The checksum word need not concern 
the user since checksums are computed by IOPS (when using IOPS Data 
Modes) . 


HEADER 
WORD 0 


1 = IGNORE | 



COUNT 

— 

V 

I/O MODE 


1 1 1 1 1 1 1 

1 1 

I . 

1 1 1 


CHECKSUM ON 
BINARY INPUT 


WORD PAIR COUNT, INCLUDING 
HEADER WORD PAIR 


VALIDITY BITS: 

00*DATA CORRECT 
01 = PARITY ERROR 


10 « CHECKSUM ERROR 
II -BUFFER OVERFLOW 


I/O MODE : 

0000 e IOPS BINARY 
0001 « IMAGE BINARY 
OOIO-IOPS ASCII 
0011- IMAGE ALPHANUMERIC 


0100 =UNUSEO 
0101 -EOF (LOGICAL) - 
0110 -EOM (PHYSICAL) 
0111-TAPE LABEL 


0 


HEADER 
WORD 1 


1 I 1 I 1 I I I 1 1 I I I I I I L 


CHECKSUM : 

TWO'S COMPLEMENT OF HEADER WORD 0 PLUS DATA 
WOROS (O-CHECKSUM NOT COMPUTED) 


15-0646 


Figure 6-2. Format of Header Word Pair 


B. Before Input 

The user need not be concerned with the header word pair since it will 
be set up by the device handler during input to enable the user to 
determine the status of his record after input has terminated. 
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C. During Input 


The Word Count (specified in the .READ Macro) is used by the device 
handler to determine the maximum number of locations provided in the 
user's input buffer for the data being read. If the Word Count is ex- 
4-u^ "-| -3 ~ c i -'- f -----e--* *--- ■■ " r,, : . 

— J . — ■ 

the handler sets the validity bits of header word 0 as required to 
indicate the error. 

D . After Input 

Header word 0 of each logical record input should be examined by the 
user program to determine whether errors have occurred. Specifically, 
the validity and I/O Mode bits should be tested. If both checksum and 
parity errors are detected by a handler, priority is given to a parity 
error and the checksum error will not be indicated. IOPS ignores check- 
sum errors on binary input if bit 0 of word 0 is set to 1. When exam- 
ining the I/O Mode Bits (bits 14-17) the occurrence of a buffer over- 
flow condition means that the user program's I/O buffer, as specified 
by the Word Count in the .READ Macro, is not large enough to contain 
the record just read. The portion of the record which caused the 
_ o v erf. low , . js lost- In addition, IOPS -uses ths- I/O -Mods Bits to ind - i = 

f'T. C t- If! ny a xoal cna'-or mcaium ( oun ; oir UIio iCa i ~ 

end-of-file (EOF) has been reached; otherwise, these bits specify the 
Data Mode of the Record. 

6.4 DATA MODES 

The device handlers within IOPS allow data transfers via .READ and 
.WRITE Macros in one of the five Data Modes listed below: 

IOPS Binary (Mode 0) 

IOPS ASCII (Mode 2) 

Image Binary (Mode 1) 

Image Alphanumeric (Mode 3) 

Dump (Mode 4) 

Data Modes permit the user to select the data structuring features of 

the system which are important to his application. The device independ- 
ent features of the system can be enhanced through the use of the IOPS 
Modes, which are standardly used by all DOS-15 System programs (e.g., 
both FORTRAN IV and MACRO-15 accept source programs in the form of IOPS 



ASCII files and produce object code as IOPS Binary files). Conversely, 
if specific device dependent features are desired, Image and Dump Modes 
can be used (primarily applicable when used with non-mass storage de- 
vices) . 

6.4.1 IOPS Modes 

The IOPS Data Modes, both ASCII and Binary are the standard data struc- 
tures of the DOS Software System. Using these modes, all ASCII and 
Binary data input is verified and converted into standard records re- 
gardless of its original form on the input device. Before output, 
programs must format data into standard IOPS records. On output, TOPS 
calculates checksums and either reconverts the data to the form required 
by the output device or, in the case of mass storage devices, stores the 
data in the standard record format. 

6 - 4 -l-l IOPS ASCII - IOPS ASCII is used by DOS-15 System 

Software as the standard ASCII Data Mode. It accommodates the entire 

7- bit ASCII (1968) 128 character set as shown in Appendix A. All 
alphanumeric data, whatever its original form on input (i.e., 8-bit 
ASCII, Hollerith, etc.) or final form on output, is converted 
internally by the non-mass storage device handlers and stored in 
core and on mass storage devices as "5/7 ASCII". This term refers 
to the internal packing and storage scheme used for IOPS ASCII 

in which five 7-bit ASCII characters are packed into two contigu- 
ous 18-bit words. Figure 6-3 shows this relationship. ASCII packed 


O'* ► 6 7* *13 14 * *17 


1ST CHARACTER 

2ND CHARACTER 

3RD CHARACTER 



1-4 


0* *2 3* ► 9 10* *16 17 


WORD 1 

3RD CHARACTER 

4TH CHARACTER 

5TH CHARACTER 


— UNUSED 
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13-0647 


Figure 6-3 5/7 ASCII Packing Scheme 
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in this form can be stored "as is" on any mass storage device. I/O 
requests involving 5/7 ASCII should be made using an even word count 
argument to accommodate the paired data. ASCII data is ordinarily in- 
put or output character-by-character via non-mass storage devices such 
as teleprinter, line printer, paper tape reader and punch. It can 
also be stored on mass storage devices in 5/7 form (see Figures 6-4 
and 6-5) . On paper tape an IOPS ASCII character is defined as a 7-bit 
character with even parity in the eighth (high order) bit, in keeping 
with USASCII standards. Further, IOPS performs a parity check on 
input, prior to the 5/7 packing and on output IOPS generates the cor- 
rect parity. 

Non-parity IOPS ASCII occurs in data originating at a Model 33, 35, 
or 37 Teleprinter, without the parity option. This data always appears 
with the eighth (high order) bit set to 1. Apart from parity checking, 
the IOPS routines handle IOPS ASCII and non-parity IOPS ASCII data identi- 
cally. 




Figure 6-5 IOPS ASCII in I/O Buffers 
and on Mass Storage Devices 
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Each logical record is an alphanumeric line, and a Carriage Return (CR) 
or ALT MODE. CR (or ALT MODE) is a required line terminator in IOPS 
ASCII mode to non-mass storage. Unused character positions in the IOPS 
Word Pair after the CR or ALT MODE are ignored. Control character scan- 
ning is performed by some device handlers for editing or control purposes 
(refer to Chapter 9). 


On input, each IOPS ASCII .READ results in a 5/7 packed ASCII line being 
placed in the program's I/O buffer. If this line is to be interpreted, 
it must be unpacked by the program. Conversely, on output each .WRITE 
assumes that the data in the user's I/O buffer is a 5/7 packed ASCII 
line. Thus, it is up to the program performing IOPS ASCII data trans- 
fers to unpack each input line and pack each output line. Appendix B 
contains assembly listings of generalized packing and unpacking routines 
which can be incorporated into user programs as required. 

6. 4. 1.2 IQPS Binary _ IOPS Binary data is blocked in an even number 
of words, with each block preceded by a two-word header (see Figure 
6-6) . On paper tape (see Figure 6-7) , IOPS uses six bits per frame, 
with the eighth channel always set to 1, and the seventh channel con- 
taining the parity bit (odd parity) for channels 1 through 6 and 
channel 8. The parity feature supplements the checksumming as a 
data validity provision in paper tape IOPS binary. 

IOPS binary. 

WORD PAIR COUNT 
(INCLUDING HEADER WORD PAIR) 

01 14 17 

HEADER 
WORD PAIR 


1 PAIRS OF 18-BIT 
[ BINARY WORDS 


tS-0651 


Figure 6-6 IOPS Binary in I/O Buffers and on Mass Storage Devices 


4 1 I 0 

CHECKSUM 
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TAPE CHANNEL 


DIRECTION 
OF TAPE 
MOVEMENT 


8 7 6 5 4 3 2 1 

FEED 



Figure 6-7 


IOPS Binary Data on Paper Tape 


6.4.2 Image Modes 

Image Mode data, both Image Alphanumeric and Image Binary, is read, 
written and stored (on mass storage devices) in the form established by 
the source or terminal device. These modes permit the user to take 
advantage of the data structuring features peculiar to non-mass storage 
devices. These modes are strictly device dependent and no checking, 
packing or interpretation of data is performed. For example, when deal- 
ing with Alphanumeric data the teleprinter editing features RUBOUT and 
CTRL U, described in 9.3.1 are ignored, as well as the IOPS ASCII line 
terminators Carriage RETURN and ALT MODE, with the line printer, how- 
ever, Carriage RETURN and ALT MODE are accepted as legal line termina- 
tors . 


Image Alphanumeric Mode results in the transfer of all eight bits of 
an ASCII character to or from an I/O buffer (see Figures 6-8 and 6-9) . 
Image Binary data is unchecksummed binary and appears on paper tape, in 
1/ 0 buffers and on mass storage devices as shown in Figures 6-10 and 



Figure 6-8 Image Alphanumeric Data in I/O Buffers 
and on Mass Storage Devices 
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Figure 6-10 Image Binary in I/O Buffers 
and on Mass Storage Devices 
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6.4.3 Dump Mode 


Dump Mode permits complete freedom in data structuring in the context 
of a file structured environment 1 . Data input or output in Dump Mode 
is not interpreted, checked or packed and record length is not limited 
by the software. Dump Mode is used to output from, or load directly 
into, any core memory area. All data transferred are treated strictly 
as 18-bit binary words (i.e., core images). No Header Word Pair is 
used. Each .READ or .WRITE statement in Dump Mode requires arguments 
which merely define the core starting address of the area input or 
output and the number of words (Word Count) to be transferred. Dump 
Mode is normally used with mass-storage devices although paper tape 
I/O is possible. With paper tape, data is interpreted on output or 
input as three six-bit frames per 18-bit word (see Figure 6-11) . 


6.4.4 Logical Record Terminators 

I OPS detects the end of each logical record transferred using a pre- 
defined group of terminators or terminating conditions. These logical 
record terminators vary with the Data Mode in effect, the particular 
device or set of devices involved, and the transfer direction (input 
or output) . Table 6-2 summarizes the terminating conditions for logi- 
cal records during input and output for each IOPS Data Mode. Detailed 
information on terminating conditions for each I/O device handler 
is provided in Appendix C. 


l The .TRAN System Macro (paragraph 6.7.13) permits user specified 
file structuring as well as data structuring. A Dump Mode transfer 
can be thought of as effectively a file structured .TRAN. 
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Table 6-2 


Logical Record Terminators 


Data Mode 

Input 

Output 

IOPS ASCII 

Carriage RETURN or ALT MODE 
Word Pair Count 1 

EOM 

Word Count 2 

EOF 1 

Carriage RETURN 

ALT MODE 

Word Pair Count 3 

IOPS Binary 

Word Pair Count 

EOM 

Word Count 2 

EOF 1 

Word Pair Count 

Image Alpha- 
numeric and 
Image Binary 

Word Pair Count 1 

Word Count 

EOM 

EOF 1 

Word Pair Count 

Dump 

Word Count 

EOM 

EOF 1 

Word Count 


1 Mass storage only. 

2 If word count is exceeded before a terminator is encountered, IOPS 
sets bits 12 and 13 of Header Word fl to 3 (Buffer Overflow). 

3 If the Word Pair Count is 1 or less, the line is ignored; if greater 
than 1, ignore the count and accept Carriage RETURN or ALT MODE (non- 
file oriented devices only) . Bulk, storage devices require a word 
Pair Count greater than 1 and less than 177g; otherwise an IOPS 23 
error will occur. 
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6 . 5 I/O BUFFERS 


6.5.1 Space Allocation 

Each system or user program which is to perform I/O operations must 
allocate an I/O Buffer for each I/O device and unit (i.e., a .DAT 
slot) that is to be used simultaneously. This can be accomplished 
by, but is not limited to, one of the methods described below. 

Static buffer allocation can be accomplished through the use of the 
MACRO-15 Assembler's .BLOCK pseudo-op as described in DEC-1 5-AMZC-D. 
A tag must be used to permit referencing of the buffer in each I/O 
Macro. For example: 


.DEC 

INBUF .BLOCK 52 /CREATES 52(10) WORD BUFFER 

/CALLED INBUF 

OTBUF .BLOCK 254 /CREATES 254(10) WORD BUFFER 

.OCT /CALLED OTBUF 

Dynamic buffer allocation can be performed through the use of the 
Monitor Macros .GTBUF and .GVBUF described in Chapter 5. Alternatively, 
the user can create a buffer at execution time from free core by simple 
calculation, using the information contained in the System Communica- 
tion Registers, . SCOM+2 and .SCOM+3 (absolute locations 102 and 103). 
These registers contain the lowest and highest addresses of the regis- 
ters in unused core, respectively. 

6.5.2 Size Considerations 

When choosing a maximum I/O buffer size to specify in the Word Count 
arguments for .READ and .WRITE I/O Macros, both the set of possible 
devices and the Data Mode must be considered. As a general rule, 
when using IOPS and Image Modes, the maximum logical record size can 
never exceed the maximum buffer sizes specified in Table 6-3, These 
are based on physical device limitations. In Dump Mode, however, there 
are no restrictions on buffer size except for the absolute bounds of 
core itself; a logical record can occupy any number of physical blocks 
on a mass storage device. Programs which are to communicate with a 
number of devices using IOPS or Image Modes must limit the output 
buffer size to that of the device with the smallest maximum buffer. 
Conversely, in setting-up input buffers, the size must be at least as 
large as that for the device with the largest maximum buffer size. 
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Table 6-3 


Maximum I/O Buffer Sizes for IOPS and Image Mode Transfers 


Device 



Data Modes 

Comments 

DECdisk (DK) 


254 

(376 8 ) 

(376g) 

All 

IOPS and Image Modes 

Disk Pack (DP) 


254 

All 

permit more than one 
logical record (de- 

DECtape (DT) 


255 

(377 8 ) 

(3 77 8 ) 

All 

pending on its size) 

Magtape (MT) 


255 

All 

per physical block. 

Dump Mode records can 
span an unlimited num- 
ber of blocks. 


Teleprinter (TT) 


34 

(42 g ) 

IOPS ASCII 

Allows for 80 5/7 
packed characters 
(though only 72 are 
printable) 




74 


Image Alpha- 

(Allows for 72 char- 





numeric 

acters) 

Paper Tape 

Reader (PR) 


52 

<64 8 > 

All 


Paper Tape 

Punch (PP) 


52 

< 64 8 > 

All 


Line Printer LP-15 


36 

CO 

IOPS ASCII 

Allows for 80 5/7 

(80 column) 


84 

Image Alpha- 

packed characters 

Allows for 80 






numeric 

characters 

Line Printer LP-1 

5 

56 

00 

o 

IOPS ASCII 

Allows for 132 5/7 

(132 column) 




packed characters. 



136 


Image Alpha- 

Allows for 132 





numeric 

characters 

Card Reader (CD) 


36 

<44 8 ) 

IOPS ASCII 

Allows for 80 5/7 
packed characters plus. 






a handler supplied 
Carriage RETURN. 

VP15A Storage 


34 

(42 g ) 

IOPS ASCII 

Allows for 80 5/7 

Tube Display 




characters (only 72 
can be displayed) 




74 


Image Alpha- 

Allows for 72 





numeric 

characters 


1 Octal representation of buffer sizes is shown for values returned after 
issuing a . INIT and indicating the maximum size which can be used for 
IOPS Modes. Other sizes shown can be used with Image Modes as 
specified. 
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For example: Consider the I/O buffer requirements for a program which 
must be capable of transferring IOPS ASCII lines to either a tele- 
printer or the DECdisk. The maximum I/O buffer size for the tele- 
printer is 34^ locations and for the DECdisk is 254 ^q locations. 
Therefore, the user should choose the smaller size since his program 
must deal with both. More importantly, if the ASCII records stored 
on the DECdisk were greater than 34 locations in length, the user 
could not transfer them back to the teleprinter without truncation 
or reformatting. 

6.6 SPECIFYING I/O DEVICES 

As mentioned in preceding chapters, the Monitor maintains a Device 
Assignment Table (.DAT), which has "slot" numbers that correspond di- 
rectly to logical device numbers. Each .DAT slot contains a pointer to 
a device handler and a unit number when applicable (for Disk Pack, 
DECtape or Magnetic Tape units) . All I/O communication in the DOS-15 
Monitor environment is accomplished by the logical/physical device 
associations provided by the Device Assignment Table. 

When writing a MACRO-15 program which uses I/O Macros, it is neces- 
sary to incorporate the MACRO-15 Assembler's . IODEV pseudo-op somewhere 
in the program to specify to CHAIN or the Linking Loader which logical 
device numbers (.DAT slots) are to be used. The .IODEV pseudo-op 
causes the Assembler to generate a code in the object program which 
instructs CHAIN or the Linking Loader to load the device handlers as- 
sociated with the specified .DAT slots. 

For example: .IODEV 3,5,6 causes the device handlers assigned to 
.DAT slots 3, 5 and 6 to be loaded with the program issuing the pseudo- 
op. 

6.7 I/O MACRO DESCRIPTIONS 

The paragraphs which follow describe the function of the I/O Macros, 
the information to be provided by the user (arguments) , and the assembly 
language expansion of each 1 . Either the I/O Macros or their assembly 
language expansions can be incorporated directly in MACRO-15 programs. 
Typical I/O command sequences are discussed in paragraph 6.8.4. 


| Paragraph 5.2.2 describes conventions and symbology used in present- 
ing the I/O Macros. 
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6.7.1 . CLEAR 


Initializes all bit maps and directories on the device. 

Eliminates all references to files in the directory of 
the device associated with the named .DAT slot. 

In order to avoid clearing a directory when its files are 
still in use, the directory is checked for open files. 

If there are no open files, the directory is cleared; 
otherwise, an IOPS 10 error Message (file still active) 
results. 

.CLEAR may only be used under! the MIC, because it will 
destroy the system. 


FORMAT: 


. CLEAR ds 

ARGUMENTS : 


ds= .DAT slot (octal radix) 

EXPANSION: (all values below are octal) 

LOC+0 CAL [-] ds&777 
LOC+1 5 


6.7.2 .CLOSE 

When directed to a .DAT slot used for input: Clears 
all flags related to that .DAT slot. This deactivates 
the .DAT slot, and another .INIT will be necessary 
to use the .DAT slot in the future. Any allocated buf- 
fer is returned. 

When directed to a .DAT slot used for output: Allows 
all associated output to finish, and then writes an 
end-of-file (EOF) 1 software indicator in the last 
header word pair. If the .DAT slot is associated with 
a directoried device, any earlier file of the same name 
and extension is deleted from the directory. Operation 
then continues as for input files (above) . 

FORMAT: 

.CLOSE ds 

ARGUMENTS : 

ds = .DAT slot (octal radix) 

EXPANSION: (all values below are octal) 

LOC+0 CAL,_j[-]ds&777 
LOC+1 6 

'001005 

776773 
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6.7.3 . DLETE 


Deletes a file from the directory of the device associated 
with the named .DAT slot. 

If the specified file cannot be found, the contents of 
the AC will be 0 on return. 


FORMAT: 


. DLETE i_|[ -] ds ,namptr 


ARGUMENTS : 

ds =» .DAT slot number (in octal radix) 

namptr = Pointer to the address of the first of 3 

words containing the .SIXBT representation 
of the name and extension of the file to be 
deleted (unused spaces must contain nulls) . 

EXPANSION: (all values below are octal) 

LOC+0 CAL+1000 t _i(-]ds&777 
LOC+1 2 
LOC+2 namptr 


6.7.4 . ENTER 

Initializes a directory for a new output file. The file 
will be placed on the device associated with the .DAT 
slot named as one of the parameters to the macro. Trans- 
fers control to the Monitor error handler to print the 
appropriate error message if there is no available space 
in the file directory. 


FORMAT: 


. ENTER|_j[-] ds , namptr ,p 


ARGUMENT: 


ds = .DAT slot (octal radix) 

namptr = Pointer to the address of the first 
of three words containing the .SIXBT 
representation of the name and exten- 
sion of the file to be created. 

p = Disk file protection code to be assigned. 
Possible values for p: 

1 - file is unprotected 

2 - file is WRITE protected 

3 - file is READ/WRITE protected 

If p is omitted, default protection code 
is used. 
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6.7.4 (Cont.) 


EXPANSION: (all 

values below are octal) 

LOC+0 

CAL+1000*puj[-]ds&777 

LOC+1 

4 

LOC + 2 

namptr 


6.7.5* . FSTAT 

Checks the status of a file in a directory. Ignored 
by non-directoried devices. The namptr parameter 
points to the name and extension of the file whose 
status is desired. On return, the AC will contain 
the first block number of the file, if the directory 
lists a file with the indicated name. The contents of 
the AC will be zero on return if the specified file 
is not on the device. It is recommended that program- 
mers use .FSTAT prior to executing .SEEK if they wish 
to retain program control when a file is not in the 
directory. 

Bits 0 through 2 of LOC+2 must be set to zero prior 
to the execution of the CAL. On return, these bits 
of LOC+2 will contain a code indicating the type of de- 
vice associated with .DAT slot ds . 

0 = non-directoried device 

1 = DECtape file structuring 

2 = RF DECdisk file structure 

3 = RP Disk Pack file structure 

4 = Magtape 

FORMAT : 


.FSTAT, J-lds .namptr 


ARGUMENTS : 

ds => .DAT slot t>ctal radix) 

namptr = Pointer to the address of the first 
of tnree words containing the .SIXBT 
representation of the name and exten- 
sion of the file (unused spaces must 
contain nulls) . 

EXPANSION: (all values below are octal) 

LOC+0 CAL+3000 l __ J [-]ds&777 
LOC+1 2 
LOC+2 namptr 
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6.7.6 . INIT 


Initializes a device and device handler. 

Programmers must give a .INIT prior to giving any 
I/O commands referencing the named .DAT slot. Any 
.DAT slot initialized via a .INIT must eventually 
be closed via a .CLOSE. 

The handler that services any .INIT will return (in 
LOC+3 of expansion) the maximum size of the line 
buffer allowed for that handler. For example, DTA 
will return 377 (255..) in LOC+3, and DKA will 
return 376 (254^) in LOC+3 of the expansion. 

FORMAT : 

. INIT . .f — 1 ds , dd ,restrt 

ARGUMENTS : 

ds = .DAT slot (octal radix) 
dd = Direction of data flow 


J0 - file will be an input file 
1 - file will be an output file 


restrt = Restart address. Although restrt must 
be included to avoid assembly time 
errors, it has meaning only for .INIT 
commands referencing .DAT slots assigned 
to the teleprinter. 

EXPANSION: (all values below are octal) 

LOC+0 CAL+dd*1000i_,[-]ds&777 

LOC+1 1 

LOC+2 restrt 

LOC+3 0 (Handler will return maximum buffer 
size in LOC+3.) 

NOTE: Bits 5, 6 and 8 of LOC+0 provide added 

information for the GRAPHIC-15 software 
the line printer handler and the disk 
handlers. See the individual handler 
descriptions for more information. 

Bit 7 of LOC+0 should always be 0. 
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6.7.7 


. MTAPE 


Performs fun ct io ns unique to industry-standard magnetic 
t 1 ■ l factions for non-directoried magnetic taoe 
(see Chact2? t 9? n * S” J ls ° P ro ' ,i ' Se ' 1 DECtape and aUk' 
Ls fo? P m"e 5 i ; fo S t ta mPtl °” ° f 


FORMAT : 


. MTAPE u [ -] ds , nn 

ARGUMENTS : 

ds = .DAT slot number (in octal radix) 

nn = code number bf magnetic tape function 
or configuration: 

00 ~ rewind to load point 

02 ~ backspace record 

03 - backspace file 

04 - write end-of-file 

05 - skip record 

06 - skip file 

01 - skip to logical end of tape 

10 - 7-channel, even parity, 200 bpi 

11 - 7-channel, even parity, 556 bpi 

12 - 7-channel, even parity, 800 bpi 

13 - 9-channel, even parity, 800 bpi 

14 - 7-channel, odd parity, 200 bpi 

15 - 7-channel, odd parity, 556 bpi 

16 - 7-channel, odd parity, 800 bpi 

17 — 9 channel, odd parity, 800 bpi 

EXPANSION: (all values below are octal) 

LOC +0 CAL+nn* 1000 l _ J [-]ds &777 

LOC+1 7 

6.7.8 . RAND 


Opens a disk file for 
the number of blocks 


random access via . RTRAN macros. Returns 
in the file in LOC+3 of the expansion. 


FORMAT : 


. -j as ,namptr 

ARGUMENTS : 

ds — .DAT slot (octal radix) 

namptr = Pointer to the first word of a 3-word, 

. SIXBT representation of the file to 
be opened (unused spaces must contain nulls) . 

EXPANSION: (all values below are octal) 

LOC+0 CAL+5000,_ # [-]ds&777 

_ r lg ? _ 

LOC+2 namptr 
LOC+3 0 
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6.7.9 . READ 


Returns the next logical record to the user's I/O buffer. 
If the record is longer than the user's I/O buffer, the 
handler will fill the buffer and the rest of the record 
will be lost. If the record is shorter than the user's 
I/O buffer, the handler will use only the part of the 
buffer it needs. The handlers use several indicators 
to determine the length of record. Appendix C, Input/ 
Output Data Mode Terminators, shows which handlers use 
what indicators for each data mode. 

Since I/O operations and internal data transfers may 
proceed asynchronously with Computation, a .WAIT command 
must be used after a .READ command before the user at- 
tempts to access the data in his I/O buffer, or to read 
another line into it. | 

The user should always check bits 14 through 17 of the 
first word of the I/O buffer for end-of-medium and end- 
of-file conditions. In non-Dump modes, the user should 
also interrogate bits 12 and 13 of the first word of the 
I/O buffer to ensure that the record was read without 
error. 

FORMAT : 


. READi_j[ -] ds ,m,bufadd,wdc 


ARGUMENTS: 


ds = 
m = 


buff add = 


.DAT slot (octal radix) 

Data Mode, as follows: 

0 *- Data Mode is IOPS Binary 

1 - Data Mode is Image Binary 

2 <- Data Mode is IOPS ASCII 

3 - Data Mode is Image Alphanumeric 

4 - Data Mode is Dump Mode 

address of user's I/O buffer 


wdc = word count (decimal radix) , includ- 
ing the two-word header, wdc should 
equal the length of the buffer at 
buf add. 


EXPANSION: (all values below are octal) 


LOC+0 CAL+m* 1000 ds&777 
LOC+1 10 
LOC+2 buf add 
LOC+3 -wdc 


6-22 



6.7.10 .RENAM 


6.7.11 


Renames a file (useful only with directoried devices) . 
The old name and extension are pointed to by namptr; 
the new name must be located at namptr+3. The AC 
will be zero on return if the file specified at 
namptr cannot be found* 


FORMAT: 

. RENAMul -] ds , namptr 


ARGUMENTS : 


ds = .DAT slot (octal radix) 

namptr = pointer to tile old name and exten- 
sion (new ndme is at namptr+3) . 
(Unused spaces must contain nulls.) 

EXPANSION: (all values below are octal) 

LOC+0 CAL+200j0 l _ J [-]ds&777 
LOC+1 2 
LOC+2 namptr 


. RTRAN 

Allows random access to blocks in a file opened via a 
•RAND I/O macro. Programmer may read or write into 
any block of a file, but may not change 
the length of the file. 

FORMAT: 


. RTRAN i_j [ -] ds , d , relblk , buf add , beg , wdc 


ARGUMENTS : 

ds * .DAT slot (octal radix) 
d = direction: 

0 - direction is input 

1 - direction is output 

relblk = block number (octal radix) rela- 
tive to beginning of the file ... 
first block is block 1, etc. 

bufadd * address of I/O buffer in user's 
core space. 

beg = first physical word of physical 
block to be lead or written. . .ig- 
nored for disk pack. . .must be 
octal radix, 0<_beg<_375. 

wdc = number of words, starting with 
beg, to be read or written... 
ignored for disk pack... must be 
DECIMAL radix, 0<_cnt^(253-beg) . 
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6.7.11 (Cont.) 


EXPANSION: (all values below are octal) 


LOC+0 

CAL+4000 I _ I [ -] ds &7 77 

LOC + 1 

2 

LOC+2 

d*400000+relblk 

LOC+3 

buf add 

LOC+4 

-beg 


.DEC 

LOC+5 

-wdc 


6.7.12 .SEEK 

Opens a file for input on a directoried device. SEEK 
is ignored by non-directoried devices. 

If the file is listed in the device's directory, the 
handler reads the first block of the file into a 
buffer. (A subsequent .READ will obtain the 
first logical record in the user's I/O buffer.) 

If the file is not listed in the device's directory, 
the handler will pass control to the error handling 
routine in the Monitor. If the user wishes to retain 
control in the case that the desired file is not in 
the directory, he should first issue a . FSTAT command. 

FORMAT : 


. SEEK,_j[ — ] ds , namptr 


ARGUMENTS : 

ds = .DAT slot (octal radix) 

namptr = pointer to the three-word .SIXBT 

representation of the name and ex- 
tension of the file to be opened 
for input. (Unused spaces must be 
null-filled.) 

EXPANSION: (all values below are octal) 

LOC+0 CALuj[-]ds&777 
LOC+1 3 
LOC+2 namptr 
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6.7.13 .TRAN 


Allows device-dependent, non-directoried input and out- 
put to any mass storage device. Users address such 
blocks by their physical locations. .TRAN should be 
followed by a .WAIT macro, to ensure that the transfer 
has been completed. 

FORMAT: 


■TRAN. J-1 ds .d .blknum .bufadd . wdc 


ARGUMENTS : 

ds = .DAT slot (octal radix) 
d = direction of transfer: 

0 - inpiit, forward 

1 *• output, forward 

2 - input, backward (DECtape only) 

3 - output, backward (DECtape only) 

NOTE: DECtape blocks must be read in the di- 

rection they were written in, in order 
to obtain meaningful results. 

blknum = block number (octal radix) of block 
at which to start input or output; 

I/O with word count larger than one 
block will continue with the next 
contiguous block; end of tape or 
disk will cause IOPS error. 

bufadd = address of I/O buffer; I/O buffer 

must be at least as long as wrdcnt. 

wdc = number of words to be transferred 
(decimal radix) 

EXPANSION (all values below are octal) : 

LOC+0 CAL+d*100jH,_ J [-]ds&777 

LOC+1 13 

LOC+2 blknum 

LOC+3 bufadd 

LOC+ 4 -wdc 
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6.7.14 .USER 


Allows users to dynamically assign UIC's to desired UFDT 
slots, thus permitting access to UFD's other than the UFD 
specified at LOGIN time (refer to paragraph 8.4). Protec- 
tion for the specified UFD and its files remains in ef- 
fect. .USER must be issued before the .INIT of the I/O 
sequence for which UFD change is desired (see example 
below) . 

FORMAT : 

■ USER, .f-lds.uic 


ARGUMENTS: 


ds - .UFDT/. DAT slot number (octal radix) 

uic = (UIC) the .SIXBT representation of the 
three-character User Identification 
Code 

EXPANSION: (all values below are octal) 

L0C+J2I CAL^JMdsi??? 

LOC+1 23 
LOC+2 uic 


For example : 

.USER 1,ABC 
.INIT 1 
.USER 1 ,CDE 

.SEEK 1 ,FILE 

.CLOSE 1 


.INIT 1 
.SEEK 1 , FILE 


This .SEEK searches for FILE under the 
JUFD called ABC 


3 


[ This . 
I UFD ca 


SEEK searches for FILE under the! 
lied CDE . 


3 
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6.7.15 .WAIT 


Obtains and holds control until the user's I/O buffer is 
available after an I/O operation. Should be used be- 
fore accessing an I/O buffer after .READ, .WRITE, .TRAN, 
and . RTRAN commands. 

FORMAT: 


• WAIT^M ds 

ARGUMENT : 

ds = .DAT slot (octal radix) 

EXPANSION: Call values below are octal) 

LOC+0 CAL^M ds&777 
LOC+1 12 


6.7.16 . WAITR 

Returns control to the address specified as an argument 
to the CAL, if I/O is not complete. If I/O is com- 
plete, returns control to next location after macro 
expansion. It is the user's responsibility to re- 
turn to the .WAITR command, or do another one. 

FORMAT : 

.WAITR [-]ds, waitad 

ARGUMENTS: 

ds = .DAT slot (octal radix) 

waitad = address to which control will be 
returned, if I/O is incomplete. 


EXPANSION: Call values below are octal) 

LOC+0 CAL+100ji [ -] ds&777 
LOC+1 12 
LOC+2 waitad 
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6.7.17 .WRITE 


.WRITE transfers a logical record from the user's I/O 
buffer to the handler's buffer. 

The .WRITE command establishes the mode in which data is 
transferred. The Header Word Pair Count determines the 
maximum amount of data to be transferred in all modes 
except Dump, which references the "wrdcnt" argument. 

The only limits on data transferred in Dump Mode are 
the size of core and the capacity of the device accept- 
ing the data. On physically blocked devices, such as 
DECtape and disk, the handler will start from its 
current position in a block and fill successive 
blocks until the transfer is complete. If a Dump Mode 
transfer does not completely fill the last block used, 
a subsequent Dump Mode transfer will fill that block, 
before using any other. 

•WAIT or . WAITR must be us^d after a .WRITE command, 
before the user's I/O buffer is used again, to ensure 
that the transfer to the device has been completed. 

FORMAT: 


. WRITE ds ,m,buf|add,wdc 
ARGUMENTS : 

ds = .DAT slot (octal radix) 
m = data mode for transfer 

P - IOPS Binary 

1 - Image Binary 

2 - IOPS ASCII 

3 - Image Alphanumeric 

4 - Dump 

bufadd = address of user's I/O buffer containing 
data to be trahsferred. 

wdc = word count, number of words to be trans- 
ferred (decimal) , (relevant for Dump 
Mode transfers only) . 

EXPANSION (all values below are octal) 

LOC+j? CAL+m*10j7?,_j[-]ds&777 
LOC+1 11 
LOC+2 bufadd 
LOC+3 -wdc 
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6.8 USING I/O MACROS 


The programmer must observe certain conventions when incorporating I/O 
Macros into a program. In general, consideration must be given to: 

o The physical device and its capabilities 

o I/O device handler characteristics 

6 The I/O Macro Syntax 

o The I/O Macro Sequence for the desired file access/ 

structure (see Chapter 4) 

6.8.1 Physical Device Capabilities 

The considerations involved here are obvious and need little comment. 
Simply stated, the user must understand the gross differences between 
various devices. For example, a. READ cannot be issued to a line 
printer. Similarly, binary data cannot be output to a teleprinter. 

i 

6.8.2 Device Handler Characteristics 

Many of the standard PDP-15 I/O devices available to DOS-15 users are 
provided with several handler versions. These versions vary from one 
to another as to the I/O Macros anc} Data Modes which are acceptable to 
them. Some versions permit the fu^l set of I/O Macros and Data Modes 
to be used, while others incorporate a subset of these features. These 
limited capability handlers are provided primarily for use where core 
allocation is a problem, since they are smaller than those with 
greater capability. The user must be aware of these handler differ- 
ences, particularly if he wishes to utilize device dependent charac- 
teristics. Detailed descriptions Of the DOS-15 device handlers are 
provided in Chapter 9. 

6.8.3 I/O Macro Syntax 

The order in which I/O Macros are used is important to the. success of 
an I/O transfer. There are basic rules of syntax which must be ad- 
hered to in order to avoid run time I/O (IOPS errors) errors. These 
rules apply to any I/O sequence directed to the same .DAT Slot. 

1. . INIT must always be issued before any other I/O 

Macro. It initializes the handler associated 
with the referenced .DAT slot for either input or 
output. Subsequent .INITs can be used to uncon- 
ditionally terminate an unwanted I/O operation. 
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Legal I/O Macro Combinations 


Commands 






Commands which may 

precede 






1 

which, may 

Misc. 

Directory Maintenance 

File Structure Initialize 

Data Transfer 

Misc. 1 

follow: 

.INIT 

•FSTAT 

.RE NAM 

.DLETE 

.CLEAR 

.SEEK 

. ENTER 

.RAND 

.MTAPE 

.READ 

.WRITE 

.RTRAN 

.TRAN 

.WAIT 

•WAITS 

.CLOSE 

. INIT 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

. FSTAT 

X 

X 

X 

X 

X 








X 

X 

X 

X 

.RENAM 

X 

X 

X 

X 

7 








X 

X 

X 

X 

. DLETE 

X 

X 

X 

X 

7 








X 

X 

X 

X 

.CLEAR 

X 

X 

X 

X 

7 








X 

X 

X 

X 

.SEEK 

X 

X 

X 

X 

7 








X 

X 

X 

X 

.ENTER 

X 

X 

X 

X 

X 








X 

X 

X 

X 

.RAND 

X 

X 

X 

X 









X 

X 

X 

X 

. MTAPE 

X 

X 

X 

X 

X 




X 




X 

X 

X 

X 

.READ 

X 





X 



X 

X 




X 

X 

X 

.WRITE 

X 






X 


X 


X 



X 

X 

X 

. RTRAN 

X 







X 




X 


X 

X 

X 

• TRAN 

■a 

X 

X 

X 

X 




■ 




X 

X 

X 

X 

.WAIT 


X 

X 

X 

X 

X 

X 

X 


X 

X 

X 

X 

X 

X 

X 

. WAITR 

■9 

X 

X 

X 

X 

X 

X 

X 


X 

X 

X 

X 

X 

X 

X 

.CLOSE 

B 

X 

X 

X 

X 

X 

X 

X 

■9 

X 

X 

X 

X 

X 

X 

X 

.USER 

■ 

■ 

X 

X 

7 

■ 


■ 

■ 

■ 


■ 

X 

7 

? 

X 


Notes: ? = Illogical Combination 

X = Legal combination 
Blank = Illegal Combination 























2. .CLOSE (or .MTAPE Rewind, for Magtape) must always 

be the last Macro issued in the sequence. It termin- 
ates the current I/O operation and use of the asso- 
ciated .DAT Slot. Another . INIT must be issued if 
subsequent transfers are to be made via this .DAT slot. 

3. I/O transfers to directoried devices (DECdisk, Disk 
Pack, DECtape or Magtape) require the use of .SEEK 
before .READ, .ENTER before .WRITE and .RAND before 
. RTRAN. 

4. Intermixing of .SEEK, .ENTER, .MTAPE, and .RAND 
Macros in the same I/O sequence (i.e. , occurring 
between an .INIT and a .CLOSE referencing the same 
.DAT slot) is illegal. 


The acceptability of specific combinations of I/O Macros is shown in 
Table 6-4. 


6.8.4 Selecting an I/O Macro Sequence 

The user has the capability of selecting command sequences which empha- 
size either device independence or device dependence, as his needs 
dictate. Much of the device independence of the DOS-15 System is ob- 
tained by using I/O Macro sequences 1 which are general enough to be 
acceptable to a wide range._pf deviqa -handlers. These sequences are 
based on sequential file access via the .READ and .WRITE I/O Macros, 
which are recognized by all DOS-15 Device Handlers. Simply by using 
•INIT - .READ (or .WRITE) - .CLOSE sequences along with the applicable 
IOPS Data Modes, a user's program has the capability of communicating 
with all non-mass storage devices (including teleprinter, paper tape 
reader and punch, line printer, card reader and VP-15 display) . By 
adding the . FSTAT, .SEEK, and .ENTER Macros, the same program can, 
in addition, utilize the system's mass storage devices (including 
DECdisk, Disk Pack, DECtape and Magtape) . The examples below further 
illustrate these sequences. 

Example 1 - Typical Output Sequence 

. IODEV 1 /Use .DAT slot 1 

•INIT 1,1, RSTRT /Initialize .DAT slot 1 for output (1) 


Optional check for existing file and 
device type, e.g., .FSTAT, .RENAM, 

. DLETE , etc. 
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Example (cont'dl 


Process data for output 


•ENTER 1 ,NAME 



NAME . S1XBT J 
BUFF .BLOCK 42 


/Output a record to .DAT slot 1 
/from BUFF in IOPS ASCII Mode. 

/Wait till buffer is free 


/File name in .SIXBT 

/Spaces are null filled (i.e., @=null) 
/I/O” buffer 


Example 2 - Input Sequence 
. IODEV 1 


% 

. IN IT 1,0, RSTRT 


Optional check for exist- 
ing file and device type 
(e.g., . FSTAT, .RENAM, 
and . DLETE Macros) . 


.SEEK 1,NAME 



NAME .SIXBT "FIL@@@SRC" /File name in .SIXBT. Spaces are 
BUFF .BLOCK 42 /null filled (i.e., @=null) 

/I/O buffer 


/Use .DAT slot 1 

/Initialize .DAT slot 1 for input (0) 
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Device dependent I/O programming is based in large part on the use of 
device-specific I/O Macro sequences and to a lesser degree on the struc- 
ture (Data Mode) of the data. For example: . RTRAN can only be 
used with disk handlers; non-mass storage devices do not need .SEEK 
or .ENTER for operation (they ignore them). Furthermore, the inter- 
pretation of data using the Image and Dump Data Modes becomes the 
user's responsibility, rather than the handler’s. The user who does 
not need device independence can eliminate unnecessary instructions 
in his program and obtain additional free core for other purposes. 

For instance, assume that in the previous examples a directoried device 
was never to be used. The programirjer could then economize by eliminat- 
ing all I/O Macros associated with il/O on directoried devices such as 
.SEEK, .ENTER, .CLEAR, . DLETE , .FSTlAT. 

Figure 6-12 shews the relationship between standard I/O Macro sequences 
and the various I/O devices and file structure/access features of the 
DOS-15 system. Except for .INIT and .CLOSE, there is no implied order 
to the macros in any particular I/O sequence shown (the reader should 
refer to paragraphs 6.7 an$ 6. 8. 3.1 for this information). 

6.8.5 Programming Example 

The following example illustrates the use of I/O Macros in a Macro-15 
Assembly Language program. The program accepts an ASCII line from the 
teleprinter keyboard, creates a file on the disk (or if the .DAT slot 
is properly assigned, on any other directoried device) , reads the file 
back from the disk, and prints it an the teleprinter. Before subse- 
quent keyboard inputs, the program prints the following message on 
the teleprinter: 

FILE ALREADY PRESENT1 1 

DO YOU WISH TO KEEP IT? (Y OR N AND CR) . 

> 

By typing a Y on the keyboard, the file previously created is saved 
and a new file is created for the next line input from the keyboard. 

By typing an N rather than a Y, the next line input from the keyboard 
is written on the disk using the filename associated with the line 
previously typed (that line will be deleted) . 

The name of the file is initially ECHO 001. A new file name is 
created each time a Y is typed in response to the above message by 
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Figure 6-12 

I/O MACROS APPLICABLE TO SPECIFIC DEVICES AND DATA ACCESS TECHNIQUES 
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incrementing the lo cat ion- in -the pr p gr aun car l l e d NAM E+ 2 -which initial ly 
contains the "001" extension of thej file name in Sixbit trimmed ASCII 
C.SIXBT pseudo-op) . This produces a series of uniquely named files 
Cone each time a Y is typed) as foljlows: ECHO 001, ECHO 002, ECHO 003 , 
ECHO 004, etc. 


The arguments used by the I/O Macros in this program are given symbolic 
names by means of MACRO-15 direct assignment statements at the begin- 
ning of the program. These names permit the programmer to change the 
real values of these arguments readily and also facilitate recall. 

The listing shown below is the sour ce listing and is followed by an as- 
sembly listing which shows how Macros are expanded at assembly time. 

The reader may wish to compare thesa expansions with the Macro descrip- 
tions in the beginning of this chapter. 


Programming Example - Source Listing 


0 I S K ■ 7 
TT!«6 
TT0«5 

1 N*0 
0UT«i 

1 OPS * 2 

.title 

DKECH0 


. IODEV 

5*6,7 

BEGIN 

. init 

DISK, OUT, RESTRT 


. I N I T 

T T I , IN.RESTRT 


.INIT 

tto.out.restrt 

START 

.fstat 

5ZA 

disk, name 


JMP 

update 

READKB 

.WRITE 

TT0, !0PS,MSG3|S4 


.read 

TTI , I0PS,BUEFER*34 


.WAIT 

.EJECT 

TT1 


lac 

sha 

UDSW 


JMP 

NEWFIL 

WRITE 

.ENTER 

DISK.NAME 


.WRITE 

DISK, IOPSiBUFfER.34 


.WAIT 

DISK 


.CLOSE 

niSK 

REAQ0T 

.INIT 

DISK, IN.RESTRT 


.SEEK 

DISK.NAME 


.READ 

DISK, I0PS.BUEFtR*34 


.WAIT 

.eject 

DISK 


.write 

TT0, I0PS, BUFFER, 34 


.WAIT 

TT0 

pestrt 

.CLOSE 

TT0 


.CLOSE 

TTI 


.CLOSE 

DISK 


JMP 

8EGIN 


/INITIALIZE DISK OUTPUT, 
/TELETYPE INPUT, 

/and teletype: output 
/IS tile present? 

/NO* INPUT KEYBOARD 
/YES, OUTPUT MSC1 AND MS&2 
/TYPE A CO AHEAD symbol <>> 
/INPUT I0PS ASCII FROM KEYB0AR0 
/WAIT UNTIL INPUT COMPLETE 

/TEST UPDATE SWITCH 

/0 REPLACE INPUT FILE 

/•'1'SAVE INPUT} CREATE NE W 0UTPT 

/create NEW disk file 

/OUTPUT DATA ON DISK 

/WAIT UNTIL OUTPUT COMPLETED 

/close file 

/INITIALIZE DISK INPUT 
/LOCATE pile "NAME" 

/READ INTO B'.JfFER 

/WAIT UNTIL READ COMPLETE 

/OUTPUT TO TELETYPE 
/WAIT UNTIL OUTPUT COMPlfTE 
/TERMINATE TELETYPE OUTPUT, 
/TELETYPF INPUT, 

/ANU disk input/output 

/LOOP FOP UPDATE OPTION 
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Programming Example - SoafCS Lifftinig tCont-1 


UPDATE 

.WRITE 

TTO. I0PS.M5Gl.34 


.WAIT 

.EJECT 

TTO 


.WRITE 

TTO # 1 OPS i MSG2 , 3 4 


.wait 

TTO 


.read 

TT I , 10PS.COM, e 


.wait 

TTI 


LAC 

C0M*2 


AND 

(7740O0 


SAD 

(544000 


JMP 

YES 


OH* 

UDSW 


JMP 

readkb 

YES 

CLC 



OAC 

uosw 


JMP 

READKB 

NEWF1L 

LAC 

MAME*2 


lrs 

3 


RTR 

RAR 


/OUTPUT MSG1 
/AND MSG2 

/ON 

/TELETYPE 

/REAO RESPONSE 

/WAIT UNTIL REAO COMPLETE; 

/GET FIRST WORD 
/SAVE FJbST SEVEN BITS 
/IS CHAR A Y 7 

/NO. SET TO REPLACE INPUT FILE 
/LOOP TO READ keyboard 
/SET UPDATE SW, TO SAVE 
/INPUT, CREATE NEW OUTPUT 
/LOOP TO READ KEYBOARD 

/change FXT 

/LEAST SIGNIFICANT digit or 

/SJX8T value of last char j n ext 

/STRIP off high PART of CODE 



LRS 

3 

/LEAST SIGNIFICANT DIGIT OF 





/sixbt value of middle CHAR JN 

EXT 


rtr 


/STRJP off HIGH PART of SIXBT 

CODE 


RAR 





LLS 

6 

/put back in ac 



AND 

(777 

/STRIP OF high ORDER part OF REMAINING 




/sixbt code for last ext char 



TAD 

(1 

/Increment TO MAKE new ext 



lRS 

6 

/REVERSE PROCESS TO FJX yP EXT 

IN 




/PROPER SIXBT 



rtl 





RAL 





LLS 

3 




rtl 





RAL 





LLS 

3 




AND 

(070707 




XQR 

(606060 




OAC 

NAME *2 




JMP 

WRITE 

/TO create new output 


‘<SG1 

mSG2-MSG1/2»10O0 

/upc for header word 0 



.ASCII 

"FILE ALREADY " 




.ASCII 

"PRESENT! ! '* < 1 5 > 




•EJECT 




MSG2 

MSG3-MSG2/2«1000 

Tl 

/WPC FOR header WORD 0 



.ASCII 

"DO YOU WISH TO 

KEEP IT ?•• 



.ASCII 

"(Y OR N aNU CR> 

> " < 1 7 5 > 


MSG3 

COm-msg3/2*1000 




.ASCII 

" > " < 1 7 5 > 



COM 

.block 

10 



rufffr 

.block 

42 



NAME 

.SIXRT 

•’ECHORP001" 



IJOSW 






.END 

BEGIN 
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Programming Example - Assembly Listing 


° AGE 1 

OKECMC 

301 

DKECHO 


1 







.title DkECHO 

2 



000007 

A 


D I SK«7 


3 



000006 

A 


TT!»6 


4 



000035 

A 


TT0»5 


5 



000000 

A 


IN»0 


6 



000001 

A 


0UT = 1 


7 



000002 

A 


I0PS*2 


8 







■IOUEV 5,6,7 

9 


R 




begin 

, I N l T disk, out, restrt 


00000 

R 

001007 

A 

•G 


CAU*OUT»1000 DISK*777 


0 0001 

R 

000001 

A 

*G 


1 


00002 

R 

000074 

R 

*G 


restrt*0 


5(0003 

R 

000000 

A 

*G 


0 

12 

00004 

R 

000006 

A 

•G 


, I N l t tti , in, RESTRT 

CALMN*1000 TTI8777 


00005 

R 

000031 

A 

•6 


1 


00006 

R 

000074 

R 

•G 


RESTRT>0 


03007 

R 

000000 

A 

#G 


3 

11 

30010 

R 

001035 

A 

*G 


, I N I T TTO, OUT, RESTRT 

CAL*CUT*1000 TT04777 


<0311 

R 

C00031 

A 

*G 


1 


3C312 

3 

000074 

R 

*G 


RESTRT+0 


30013 

R 

000000 

A 

• G 


0 

12 

0 0014 

R 




start 

.PSTaT DISK, NAME 


0 0014 

R 

303007 

A 

•G 


CAL*3000 DISK4777 


00215 

R 

000002 

A 

*G 


2 


00316 

R 

000301 

R 

»G 


NAME 

13 

00017 

R 

740200 

A 



SZA 

14 

30220 

R 

600103 

R 



JMP UPDATE 

15 

0 0 3 21 

R 




readkB 

.WRITE TTO, I0PS.MSG3.34 


30021 

R 

302025 

A 

*G 


CALMOPS.1000 T T 0 6 7 7 7 


00322 

R 

G00011 

A 

•G 


11 


0 0323 

R 

000223 

R 

*G 


y SG3 






*G 


.DEC 


.'0324 

P 

777736 

A 

•G 


-34 

.EJECT 


/INITIALIZE DISK OUTPUT, 


/TELETYPE input, 


/aNO teletype output 


/is pile present? 


/NO, INPUT KEYBOARD 
/YES, OUTPUT MSGl AND HSG2 
/TYPE a GO AHEAD SYMBOL (>) 



Programming Example - Assembly Listing (Cont.) 


PACE 2 
16 


17 


18 

19 

20 
21 
22 

i 

u> 

00 

23 


24 


2b 


26 


DKECH0 eoi OKECHO 

710225 R 002006 A *G 

00026 R 000010 A «G 

00027 R 000237 R *G 

•G 

00030 R 777736 A *G 

00031 R 000006 A *G 
70032 R 000012 A »G 

00033 R 200304 R 

70034 R 740200 A 

70035 R 600136 R 

70036 R WRITE 

v' 0 0 3 6 R 000007 A *G 

70037 R 000004 A *G 

00040 R 000301 R *G 

00041 R P02007 A »G 
70742 R 000011 A *G 
0P043 R 000237 R *G 

•G 

70044 R 777736 A *G 

70045 R 030077 A *G 
•0046 R 000012 A *G 

10347 R 000007 A *G 
.'0050 R 000006 A «G 
7 C 7 5 l R READDT 

70051 R 030007 A *G 
T0752 R 700001 A *G 
00053 R £33074 R »G 
70054 R 700030 A *G 


.READ TTJ.JOPS, BUFFER, 3« 
CAL*lOPS»1000 TTM777 
10 

8UFF£R 

,OEC 

-34 

.WAIT T T I 
CAL TT I 4777 
12 

LAC UOSW 

32 A 

JMP nEWFIL 

.ENTER disk, name 
♦C AL*1000 DISK4777 
4 

NAME 

.write disk, iops, buffer, 34 

CAL*IOPS#1000 DISK*777 
11 

BUFFER 

.DEC 

-34 

.WAIT PJSK 
CAL 0ISK4777 
12 

.CLOSE PISK 
CAL D I SK 5 777 
6 

, INlT DISK, IN.RESTRT 
CAL+IN*1030 DISK4777 
1 

«ESTrT*0 

0 

.EJECT 


/INPUT IOPS ASCII FROM KEYBOARD 

/WAIT UNTIL INPUT COMPLETE 

/TIST UPDATE SWITCH 

/0 REPLACE INPUT FILE 

/el *S AVE INPUT! CREATE NEW OUTPT 

/CREATE NEW OISK FILE 

/OUTPUT DATA ON DISK 

/WAIT UNTIL OUTPUT COMPLETED 
/CLOSE FILE 

/INITIALIZE OISK INPUT 



Programming Example - Assembly Listing (Cont. ) 


PAGE 3 DKECHO 001 okecho 


27 

00055 

R 

000007 

A 

• G 

,SEtK DlSKiNAMC 

CAL DISK*777 

/LOCATE FILE "NAME" 


00056 

R 

000033 

A 

*G 

3 



00057 

R 

000301 

R 

•G 

NAME 


28 

00060 

R 

002007 

A 

•G 

.READ DISK, I0PS, BUFFER, 34 

CALMOPS*1000 D1SK*777 

/READ INTO BUFFER 


00061 

R 

000010 

A 

*G 

10 



00062 

R 

000237 

R 

•G 

BUFFER 







•G 

, DEC 



00063 

R 

777736 

A 

•G 

*34 


29 

30064 

R 

000007 

A 

•G 

.WAIT DISK 

CAL 0ISK«777 

/WAIT UNTIL READ COMPLETE 


30065 

R 

000012 

A 

•G 

1 2_ „ 


31 

30066 

R 

002005 

A 

*G 

.WRITE TTDiIOPS. BUFFER, 34 
CAI,*!OPS*im TT04777 

/OUTPUT TO TELETYPE 


00067 

R 

000011 

A 

*G 

11 



00070 

R 

000237 

R 

*G 

BUFFER 







*G 

,OEC 



30071 

R 

777736 

A 

•G 

*34 


32 





.WAIT t T 0 

/WAIT UNTIL OUTPUT COMPLETE 


30372 

R 

000005 

A 

*G 

CAL TT04777 



00073 

R 

000012 

A 

•G 

12 


33 

30074 

R 



RESTRT 

.CLOSE TTO 

/terminate teletype OUTPUT, 


00074 

R 

000005 

A 

*G 

CAL TT04777 



00075 

R 

000006 

A 

*G 

6 


34 

30076 

R 

000006 

A 

*G 

.CLOSE fT! 

CAL TT I 4777 

/TELETYPE INPUT, 


P0077 

R 

000006 

A 

*G 

6 


35 

30100 

R 

000007 

A 

*G 

.close disk 

CAL DISK«777 

/ANO DISK INPUT/OUTPUT 


30101 

R 

000006 

A 

•G 

6 


36 

30102 

R 

6 0 0 E 0 0 

R 


JMP BEGIN 

.EJECT 

/LOOP FOR UPDATE OPTION 



Programming Example - Assembly Listing (.Cont.) 


PAGE A 

DKECHP 

001 

DKECMO 



37 

00103 

R 



UPOATE 

.WRITE TTO, !0PS.mSG1,34 

/OUTPUT hSGI 


00103 

R 

202305 

A 

*G 

CAL*IOPS«1003 TT03/77 



00104 

R 

000011 

A 

•G 

11 



00105 

R 

000163 

R 

•G 

mSGI 







•G 

. DEC 



00106 

R 

777736 

A 

•G 

<•34 

/ANO MSG2 

38 





.wait ttO 


00107 

9 

000005 

A 

*G 

CAL TTQS777 



00110 

R 

000012 

A 

• G 

12 


40 

00111 

R 

002035 

A 

•G 

.WRITE TTO, I0PS»mSG2*34 
CAL*IOPS*1000 TT04777 

/ON 


00112 

R 

000011 

A 

*G 

11 



00113 

R 

000177 

R 

•G 

MSG* 







•G 

.DEC 



00114 

R 

777736 

A 

•G 

•>34 


41 

00115 

R 

030005 

A 

•G 

.WAIT TTO 

CAL TT08777 

/TELETYPE 


00116 

R 

000012 

A 

•G 

12 


42 

00117 

R 

002006 

A 

•G 

,REA0 T T I , I OPS i COM • 8 

CAL* I OPS*1003 TTI«777 

/READ RESPONSE 


?012? 

R 

000010 

A 

•G 

10 



00121 

R 

000227 

R 

•G 

COH 







*G 

.DEC 



00122 

R 

777770 

A 

*G 

• 8 


43 

00123 

R' 

000006 

A 

*G 

.WAIT rTJ 

CAL TT I 8777 

/WAIT UNTIL READ COMPLETE 


■00124 

R 

000012 

A 

•G 

12 


44 

•70125 

R 

200231 

R 


LAC C0Mw2 

/GET PIRST WORD 

45 

0 0126 

c 

5003C5 

R 


AND (774002 

/SAVE FIRST SEVEN BITS 

46 

00127 

9 

540306 

R 


SAD (544200 

/IS char a y? 

47 

0013C 

a 

600133 

R 


JMP yes 


48 

00131 

a 

1 4 0 3 C 4 

R 


D*M t'DSw 

/NO, SET TO REPLACE INPUT 

49 

0013? 

a 

600021 

R 


JYP rEADKB 

/LOOP TO READ KEYBOARD 

50 

00133 

R 

750321 

A 

YES 

CLC 

•EJECT 

/SET UPDATE SW, TO SAVE 
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Programming Example - Assembly Listing (Cont. } 


PAGE 

5 

DKEGHO 

001 

dkecho 




51 


00134 

R 

040334 

R 

0 AC 

IjDSW 

/INPUT, CREATE ME« OUTPUT 

52 


00135 

R 

600021 

R 

JMP 

rEADkB 

/LOOP TO READ KEyBOARO 

53 


00136 

R 

200333 

R NEUFIL 

LAC 

fvA*E*2 

/CHANGE EXT 

54 


00137 

R 

640503 

A 

lrs 

3 

/LEAST SIGNIFICANT digit of 

55 








/SJX8T Value of last char in ext 

56 


00140 

R 

742020 

A 

rtr 


/STRIP OFF HIGH PART OF CODE 

57 


00141 

R 

740020 

A 

par 



56 


00142 

R 

640503 

A 

LRS 

3 

/least significant digit of 

59 








/SJXBT VALUE OF mIOOlE CHAR IN EXT 

60 


00143 

R 

742020 

A 

RTR 


/strip off high part of sixbt code 

61 


00144 

R 

740020 

A 

RAR 



62 


00145 

R 

640606 

A 

LIS 

6 

/PUT BACK IN AC 

63 


00146 

R 

500307 

R 

AMO 

(777 

/STRIP OF HIGH ORDER PART OF REHAIN 

64 








/SIXBT COOf FOR LAST EXT CHAR 

65 


00147 

R 

340310 

R 

TAO 

(1 

/INCREMENT TO MAKE NEW EXT 

66 


00150 

R 

640506 

A 

lrs 

6 

/REVERSE PROCESS TO FIX UP EXT IN 

67 








/PROPER SIXBT 

68 


00151 

R 

742010 

A 

RTL 



69 


00152 

R 

740010 

A 

RAL 



70 


00153 

R 

640603 

A 

LLS 

3 


71 


00154 

R 

742010 

A 

RTl 



72 


30155 

R 

740010 

A 

RAL 



73 


30156 

R 

640603 

A 

LLS 

3 


74 


00157 

R 

530311 

P 

AMO 

(070707 


75 


•30160 

R 

240312 

R 

XOR 

( 606060 


76 


P0161 

R 

040303 

R 

DAC 

nAME«2 


77 


00162 

R 

600036 

R 

JMP 

WRITE 

/TO CREATE NEW OUTPUT 

78 


00163 

R 

006000 

A HSGl 

MSGZ-MSG1/2*1000 

/HP C FOR HEADER WORD 0 

79 


00164 

R 

000000 

A 

0 

"file alreaoy * 


60 


00165 

R 

432231 

A 

•ASCII 




00166 

R 

442500 

A 






30167 

a 

406312 

A 






00170 

R 

242632 

A 






00171 

R 

422624 

A 






C0172 

R 

000000 

A 


"PRESENT! ! " < 1 5 > 


81 


00173 

R 

502450 

A 

.ASCII 




^0174 

R 

551612 

A 






30175 

a 

472504 

A 






00176 

R 

120432 

A 






Programming Example - Assembly Listing (Cont.) 


PAGE 6 DKECHO 001 DKECHO 

83 JJ0177 R 012000 A MSG2 MSG3-MSG2/2«1002 /wPC FOR HEADER WORD 0 

84 00200 R 000000 A 0 

85 00231 R 422364 A .ASCII "oO YOU WISH TO KEEP IT 7" 

00202 R 054636 A 

00203 R 525012 A 

00204 R 744646 A 

00205 R 441012 A 

00206 R 447500 A 

00207 R 456130 A 

00210 R 550100 A 

00211 R 446504 A 

00212 R 337400 A 

86 ge213 R 242624 A .ASCII "<Y OR N AN° CR) >"<l75> 

00214 R 047644 A 

1*0215 R 202344 A 

00216 R 340634 A 

00217 R 421010 A 
0022? R 351122 A 
00221 R 201037 A 



00222 

R 

676400 

A 





87 

30223 

R 

002030 

A 


MSG3 

COM"MSG3/2*1000 

88 

00224 

R 

000000 

A 



0 


89 

00225 

R 

373720 

A 



.ASCII 

H >"<1 75> 


00226 

H 

000030 

A 





90 

30227 

R 


A 


COM 

, BLOCK 

10 

91 

*023 7 

R 


A 


BUFFER 

. BLOCK 

42 

92 

30301 

R 

050310 

A 


name 

.SJXBT 

"ECHCM001 


03302 

R 

170000 

A 






00303 

R 

606061 

A 





93 

30304 

R 

330000 

A 


UDSW 

0 


94 



070030 

R 



,£NO 

BEGIN 


30305 

R 

774000 

A 

*L 





30306 

R 

544030 

A 

*L 





0 C307 

R 

370777 

A 

*L 





,, 031 * 

a 

003031 

A 

*L 





00311 

R 

C 73 737 

A 

*L 





00312 

R 

606060 

A 

•L 





SI?E«00313 


NO ERROR 

lines 




Program Example - Assembly Listing (Cont.) 


PAGE 

7 DKECHO 1 

:ros$ i 

REFERENCE 






BEGIN 

00000 

9* 

36 

94 







buffer 

00237 

16 

23 

28 

31 

91* 





COM 

00227 

42 

44 

8 7 

90* 






11SK 

000007 

2* 

9 

1? 

22 

23 

24 

25 

26 

27 



29 

29 

35 







I N 

000000 

5* 

10 

26 







IOPS 

000002 

7* 

15 

16 

23 

28 

31 

37 

40 

42 

HSG1 

00163 

37 

78* 

78 







MSG2 

00177 

4C 

78 

83* 

83 






MSG3 

00223 

15 

83 

07* 

87 






name 

30301 

12 

22 

27 

53 

76 

92* 




newfil 

30136 

21 

53* 








OUT 

000001 

6* 

9 

11 







READ3T 

03051 

26* 









READkB 

33021 

15« 

49 

52 







PESTRT 

00074 

9 

10 

11 

26 

33* 





start 

00014 

12» 









TTI 

000006 

3* 

10 

16 

17 

34 

42 

43 



T TO 

000305 

4 a 

11 

15 

31 

32 

33 

37 

30 

40 



41 









UDSw 

00304 

19 

48 

51 

93* 






JPOATE 

00103 

14 

37* 








» R I T E 

00336 

22* 

77 








VES 

3013? 

47 

50* 










6.8.6 File Integrity Considerations 


In a system such as DOS-15, which offers a flexible I/O command reper- 
toire, I/O programming requires care. . .otherwise, numerous IOPS errors 
may result. Further, there are I/O sequences which the system allows., 
which, if carelessly used, can result in the destruction of the user's 
files or those of others. The paragraphs below describe some important 
considerations. 

a. Extreme care must be exercised when using the .TRAN macro to 
output to the DECdisk, Disk Pack, DECtape or Magtape. The user 
must know the disk and DECtape file structures completely, be- 
cause .TRAN operates completely outsj.de these file structures, 
and ignores the existence of all directories and bit maps. The 
entire contents of the disk or DECtape or Magtape, therefore, 
are vulnerable to the user of .TRAN. 

b. Caution should be used when reading a file from the disk se- 
quentially (.READ) from one DAT slot, while modifying the 
same file via another .DAT slotusing random access ( . RTRAN) . 

c. Generally speaking, output files are not recognized by the 
system until they are .CLOSEd. Under most circumstances, 
termination of program control and return to the Monitor 
will cause the Monitor to delete any unclosed output files. 
Occasionally, a system crash or other unusual phenomenon 
will cause a disk output file to be truncated. Truncated 
files are the remains of output, files that the system did 
not get a chance to delete. Directory listings from PIP 
that contain an asterisk (*) after a file name indicate a 
truncated file. They take up disk space and should be 
deleted via commands to PIP. 


6-44 



CHAPTER 7 


SYSTEM INITIALIZATION 


7 . 1 INTRODUCTION 

This chapter describes the procedures to be followed when loading, 
starting, and tailoring the DOS-15 Software System. Under normal cir- 
cumstances, these procedures should rarely need to be used. Occasion- 
ally, however, a program may enter a runaway condition which could re- 
sult in the inadvertent destruction of a part of the DOS-15 software 
residing on the system device or in core. In addition, it may be neces- 
sary to change the DOS-15 software Configuration from time to time to 
permit the use of a new I/O device Or system program. These alterations 
to the system are Only permitted to be performed by those who have 
access to the system's Monitor Identification Code (MIC). Thus, the 
average user need not be concerned with the contents of this chapter 
except as regards the loading and use of the DOS-15 Bootstrap (Para- 
graph 7.3.2) . 


Chapter 10 contains the operating procedures to be used once the system 
is loaded and running. 

7.2 HOW THE SYSTEM SOFTWARE IS SUPPLIED 


The DOS-15 Monitor and System Programs are supplied to users on 
either DECtape or Magtape, depending upon the particular hardware con- 
figuration. The software system resides on the DECtape or Magtape 
medium in a special form which is nieaningful only to those programs 
which can transfer the system to thte disk. Thus, these tapes are often 
called "disk restore tapes" as they! may only be used for this purpose. 
The DOS-15 Software System occupies two reels of DECtape or one 7- or 
9-track reel of Magtape which are identified as follows 1 : 

RF Disk RP Disk 

DECtape 

Tape #1 DEC-15-MKDA-UC DEC-15-MKAA-UC 

Tape #2 DEC- 15-MKDA-UC DEC-15-MKAA-UC 

Magtape DEC-15-MPMA-M7 DEC-1 5-MPZA-M7 

(7 channel) (7-channel) 

DEC-15-MPMA-M9 DEC-15-MPZA-M9 

(9-channel) (9-channel) 

J An additional DECtape (DEC-15-FFDA-UB) or Magtape (DEC-15-FFDA-M7 , 7- 
channel; DEC-15-FFDA-M9 , 9-channel) is required for systems with the 
optional FP-15 Floating Point Processor. The installation and loading 
of software contained on these tapes is described in the SGEN-DOS Manual 
(DEC-15-YWZB-DN12 ) . 
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Two paper tape programs are also prwiderd to assist the user in load- 
ing and starting the DOS-15 system; namely the Disk Save/Restore pro- 
gram DOSSAV (DEC-15-YIDA-PB) and DOS-15 Bootstrap (RFBOOT - RF15 
Multicore Bootstrap, DEC-15-LWDA-PH> RPBOOT - RP02 Multicore Bootstrap, 
DEC-15-LWAA-PH) . 

7.3 SYSTEM STARTUP PROCEDURES 

The following paragraphs describe tfie procedure for loading and start- 
ing the DOS-15 Software System using the DOSSAV and DOS-15 Bootstrap 
programs . 

7.3.1 Disk Restoration (DOSSAV 

The DOS-15 Software* System is transferred from the Disk Restore DEC- 
tapes or Magtapes supplied by Digital Equipment Corporation to the 
appropriate disk device using the DOSSAV utility program. This program 
provides users with the ability to save and subsequently restore all 
occupied blocks on the disk using either DECtape, Magtape, DECdisk, or 
Disk Packs as the storage medium. Though the program is most often 
used to install the DOS-15 System, it can also make additional copies 
of the system currently on the disk,, of a newly tailored system (i.e. , 
after System Generation) ,..Qr_.of_thej_CQnLtfiaita,..of-_Disk Pack units 1-7 
(in the case of multiple Disk Pack Systems). 

DOSSAV operates interactively via the console teleprinter and asks the 
user a series of questions to determine which devices and unit numbers 
are to be used and, for Magtape, parity, density and track count in- 
formation. When all necessary information has been obtained, DOSSAV 
automatically begins the specified operation. If a save or restore 
operation requires more than one tape, the program stops and outputs 
a message on the teleprinter to that effect. The user can then mount 



detect both hardware and command st-i-inn prrnrc and on +-nn 4- e anononn ^ = 4-0 
messages on the teleprinter. 


In addition, the program permits DECdisk users to restore systems 
created in a small DECdisk configuration to an environment with a 
larger DECdisk configuration. The reverse situation, however, is not 
possible. The DOS-15 Disk Restore tapes supplied by Digital for a 
one-platter system configuration, therefore, can be restored to any size 
DECdisk system configuration 1 . DOSSAV is a stand-alone program supplied 

1 This type of operation should only be done with master tapes (or copies 
of them) since block 1775g must not be occupied when performing a restora- 
tion to a system with 5 or more platters. 
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in paper tape form (identification number ~ DEC-15-YIDA-PB) and is loaded 
via the high speed paper tape reader using the PDP-15's Hardware Readin 
Mode (load address - 37720, restart address 345 00) . 

7. 3. 1.1 Operating Procedures - The following procedures should be 

used when restoring or saving the DOS-15 System Software (or other user- 
created data on Disk Pack units 1-7) : 

a. Place the DOSSAV paper tape in the Paper Tape Reader. 

b. Set the console ADDRESS switches to 37720. 

c. To restore the disk: 

1) Mount the DOS-15 Disk Restore DECtape or Magtape 
for the appropriate hardware configuration (i.e., 

DECdisk, Disk Pack, Floating Point or non-Floating 
Point hardware) on the applicable tape drive. 

2) . Set the DECtape drive WRITE ENABLE/LOCK switches 

to LOCK. (Magtape us^rs should remove the Write 
Enable ring from the tape reel.) 

3) Set the disk READ/WRITE PROTECT switches to ENABLE. 

To save the contents of the disk: 

11 Mount a fresh tape on the appropriate tape drive. 

21 Set the DECtape WRITE ENABLE/LOCK switch to ENABLE. 

(Magtape users should install the Write Enable ring 
on the tape reeL ) 

d. Set the tape drive unit number switches as desired. Set 
the Disk Pack unit number switches as desired (DOS-15 
Disk Pack Systems must be restored to unit 0) . 

e. Set all ON LINE/OFF LINE switches of the devices being 
used to ON LINE. 

f. Press the Console Switches STOP and RESET simultaneously, 
then press the READIN switch. (The DOSSAV tape should 
pass through the reader.) 

7. 3. 1.2 Commands - Once the paper tape has been read in, DOSSAV will 
identify itself on the teleprinter and begin to ask the user a series 
of questions about the devices to be used, as shown in Table 7-1. 

Each user response must be terminated by a Carriage RETURN. It should 
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also be noted that some of the questions shown are typed out only 
when applicable (i.e. , no questions are asked about Disk Pack unit 
numbers or Magtape parity, density, or number of channels if these 
devices are not to be used) . Legal input and output device combina- 
tions are shown in Table 7-2. 


Table 7-1 
DOSSAV Commands 


Query 

User Responses 

INPUT DEVICE? 

DT = DECtapfe, MT = Magtape, DK = DECdisk, 

DP = Disk Pack 

UNIT NO? 

Legal unit humbers are 0-7 

TRACK (7 OR 9) ? 

Magtape track or channel number. (If 9 is 
specified, density is assumed to be 800 BPI.) 

DENSITY (2,5,8)? 

Magtape recording density: 2=200 Bits Per 

Inch (BPI 1 , 5=556 BPI, 8=800 BPI. 

PARITY (E OR 0)? 

Magtape parity scheme: E = even parity, 

O = odd parity. 

OUTPUT DEVICE? 

(See INPUT DEVICE above.) 

UNIT NO? 

(See UNIT NO. above.) 

TRACK (7 OR 9)? 

(See TRACK above. ) 

DENSITY (2,5,8)? 

(See DENSITY above.) 

PARITY (E OR 0)? 

(See PARITY above.) 

DATE CREATED: 

The date that the restore tape was created 
is typed out by DOSSAV. 


Table 7-2 


Legal DOSSAV I/O Device Combinations 



Output 

Dev 


DEC- 

disk 

(DK) 


Disk 

Pack 

(DP) 


DEC- 

tape 

(DT) 


Mag- 

tape 1 

(MT) 


DECtape (DT) 
Magtape (MT) 
DECdisk (DK) 
Disk Pack (DP) 


OK 

OK 

Illegal 

OK 


OK 

OK 

OK 

Illegal 2 


Illegal 

Illegal 

OK 

Illegal 


Illegal 

Illegal 

OK 

Illegal 


1 All DOS-15 System Restore Magtapes distributed by DEC are 800 bpi. Odd 
Parity. 

2 Use PIP Utility program with no switch options for this operation 
(refer to DEC-15-YWZB-DN13 ) . 












Once the last question has been answered, DOSSAV proceeds with the 
specified operation. If additional tapes are required to complete 
the restore or save operation, the following message is output: 

TAPE DONE. MOUNT ANOTHER 

At this point, the user should either mount a fresh tape, if a save 
operation is being performed, or mount the next tape in the sequence 
established at tape creation, if a restore operation. Then type any 
character followed by a Carriage RBTURN to proceed with the operation. 
When the requested operation is entirely complete, DOSSAV restarts 
and identifies itself as before: 

DOSSAV Vnn 
INPUT DEVICE? 


At this point the current restore or save operation is complete. If 
the DOS-15 Software was being restored, it is now ready to be started 
as specified in 7.3.2. If other DOSSAV operations are desired, the 
user should proceed again as specif ied in 7. 3. 1.1. 

7. 3. 1.3 Examples of DOSSAV Commands - The following examples illustrate 
typical DOSSAV commands when restoring and saving the DOS-15 Software 
System. User responses are underlined. 


Disk Restoration! 

11 Restore DECdisk system from DECtape unit 1: 


DOSSAV V3A 

INPUT DEVICE? DJ 

UNIT #? 1 

OUTPUT DEVICE? DK 

DATE CREATED: T7-0CT-71 

TAPE DONE. MOUNT ANOTHER! . . .. 

q (The user mounted the next tape, 

— then typed a G J to continue . ) 

DOSSAV V3A (Operation complete DOSSAV 

INPUT DEVICE? restarts.) 
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2) Restore DECdisk system from Magtape unit 0: 

DOSSAV V3A 
INPUT DEVICE? MT 
UNIT #? 0 
TRACK (7 OR 9)? 7 
DENSITY (2,5,8)? 8 


PARITY (E OR 0)7 0 
OUTPUT DEVICE? 

DATE CREATED: 12 NOV 71 


DOSSAV V3A 
INPUT DEVICE? 


3) Restore Disk Pack System from 

DOSSAV V3A 
INPUT DEVICE? DT 
UNIT #? 1 
OUTPUT DEVICE? DP 
UNIT #? J. 

DATE CREATED 12-NOV-71 
TAPE DONE, MOUNT ANOTHER 

l 


DOSSAV V3A 
INPUT DEVICE? 


(All DOS-15 System Disk Restore 
magtapes are 800 BPI, Odd Parity.) 


(Operation complete) 


DECtape unit 1: 


(The user mounted the next 
tape, then typed a p; to con- 
tinue . ) 

(Operation complete.) 


4) Restore Disk Pack system £rom Magtape unit 1: 


DOSSAV V3A 
INPUT DEVICE? MT 
UNIT #? 1 
TRACK (7 OR 9)? _I 
DENSITY (2,5,8)? 1 
PARITY (E OR 0)? 0. 
OUTPUT DEVICE7 JDP 
UNIT #? 0. 

DATE CREATED: 12-N0V-7! 


INPUT DEVICE? (Operation complete.) 


lsaving the Contents of the Disk| 

The single example below should suffice in illustrating this type of 
operation, since save operations are simply the reverse of restore 
operations . 
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Save a DECdisK system on DECtdpe Urtit 1; 


DOSSAV V3A 
INPUT DEVICE? DJL 
OUTPUT DEVICE? DT 
UNIT#? I 

TAPE DONE. MOUNT ANOTHER 

L 


(DOSSAV allows for as many 
DECtapes or Magtapes as are 
necessary to contain the en 
tire contents of the speci- 
fied disk. ) 


DOSSAV V3A (Operation complete.) 

INPUT DEVICE? 


7. 3. 1.4 Error Messages and Meanings - DOSSAV attempts to detect all 
keyboard and run-time errors and t<i recover if possible. The three 
types of errors which can occur arg shown below along with their 
meaning and recovery procedures whgn applicable. 

a. Command String Errors - These errors occur when a 
question is answered incorrectly. DOSSAV repeats 
the question. 


Message 
ILLEGAL DEVICE 


BAD TRACK 

BAD DENSITY 

BAD PARITY 


Meaning 

Either an illegal device mnemonic (one 
other than DT, MT, DK, or DP) or an il- 
legal combination of devices (DT for 
input and MT for output) was typed. 

A track number other than 7 or 9 was 
typed. 

A density other than 2(200 BPI) , 5(556 
BPI) or 8(800 BPI) was typed. 

A parity other than E (even) or O (odd) 
was typed. 


b. Recoverable Operating Errors - These errors occur when 
one of the I/O devices is not properly set up. When 
the condition has been corrected, operation can be re- 
sumed by typing any character followed by a Carriage 
RETURN. 


Message 


TAPE NOT READY 


DISK NOT READY 


Meaning 

The DECtape or Magtape unit is not 
switched to ON LINE, is not set to 
WRITE ENABLE, or is not set to the 
unit number specified in the UNIT 
NO? question. 

The DECdisk is not set to WRITE ENABLE. 


DISK PACK NOT The Disk Pack unit is not switched to 
READY ON LINE, is not set to WRITE ENABLE or 

is not set to the unit number specified 
in the UNIT NO? question. 
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c. Unrecoverable Errors - Errors associated with these 
messages are primarily hardware errors from which 
DOSSAV cannot recover. After the message is typed, 
DOSSAV restarts itself. 


Message 


Meaning 


DECTAPE ERROR 
MAGTAPE ERROR 
DECDISK ERROR 
DISK PACK ERROR 


ATTEMPT TO RESTORE SYSTEM 
TO WRONG DISK 


Hardware error detected 


The user tried to restore a 
DECdisk system using a Disk 
Pack restore tape or vice 
versa. 


BLK 1775 OCCUPIED. NO The user did not use a master 

2ND SAT CREATED. restore tape (i.e., block 1775 

occupied) when restoring a sys- 
tem created for 4 or fewer 
platters to a system having 5 
or more platters. 


7. 3.1.5 Restart Procedures - The restart procedures below should be 
used either to terminate prematurely the current operation or to re- 
initialize DOSSAV if it fails to start up automatically after an error. 


a. Press the Console Switches STOP and RESET simultaneously. 

b. Set the ADDRESS switches to 34500. 

c. Press the START Console Switch. 

DOSSAV should then identify itself as when originally loaded, other- 
wise it must be reloaded as described in Paragraph 7. 3. 1.1. 

7.3.2 Loading and Starting the Monitor 

The DOS-15 Monitor is loaded into core from either the DECdisk or Disk 
Pack and is automatically started with the DOS-15 Bootstrap Loader 
program. Once loaded, the bootstrap remains in the upper 1418 locations 
of the core bank into which it was loaded during all normal system 
operation. The bootstrap not only aids in initializing the Monitor, 
but also acts as an integral part of the Monitor as it operates. It 
is supplied on paper tape in two versions. One version, RFBOOT , 
(identified as DEC— 15-LWDA-PH) is for use with DECdisk systems, and 
the other version, RPBOOT, (identified as DEC-15-LWAA-PH) is for use 
with Disk Pack Systems. 
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Each time that the DOS-15 System Software is restored using DOSSAV, 
the bootstrap must be loaded into core. Occasionally, a runaway pro- 
gram or hardware malfunction may cause the destruction of the Monitor 
as it resides in core, and prevent the user from restarting it by 
keyboard command. In this circumstance, it is often possible to re- 
start the bootstrap (unless it, too, has been destroyed) and avoid 
reloading the bootstrap. The paragraphs which follow describe the 
initial loading and restart procedures for the DOS-15 Bootstrap 
Loader. 


7. 3. 2.1 Loading the Bootstrap 

a. Select the appropriate version of the bootstrap (either 
DECdisk or Disk Pack) and place it in the paper tape 
reader. 

b. Set the console ADDRESS switches to one of the addresses 
shown below in accordance with the maximum core size 

of the system. 


Address 


Maximum Core Size 


37637 

57637 

7763-7- 


16K or 20K 
24K or 28K 
32K 


c. Press the console switches STOP and RESET; then press 
READIN. 


Once the bootstrap is loaded, it starts automatically and loads the 
Monitor from the disk. When loading is complete, the Monitor gets 
control and identifies itself on the console teleprinter as follows: 


DOS -15 Vnn 

ENTER DATE MM/DD/YY 


The system is now loaded and operabLe and is ready to accept the key- 
board commands (Chapter 8) in accor lance with the operating procedures 
described in Chapter 10. Users wit|i new systems, that is, systems 
which have not previously been tailbred, should refer to Paragraph 


7.4.2. 


7. 3. 2. 2 Bootstrap Restart Procedures - As mentioned above, situations 
occasionally arise in which the Monitor must be reloaded by the boot- 
strap. If the bootstrap is intact; in core, it may be restarted by 
the procedures which follow. 
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a. Set the console ADDRESS switches to one of the ad- 
dresses shown below in accordance with the maximum 
core size of the system. 


Address 


Maximum Core Size 


37646 

57646 

77646 


16K or 20K 
24K or 28K 
32K 


b. Press the console switches STOP and RESET; then 
press START. 

c. The Monitor should then identify itself as shown 
in 7. 3. 2.1. 

d. If the Monitor does not identify itself, the boot- 
strap has been destroyed and must be reloaded as de- 
scribed in 7. 3. 2.1. 

7.4 SYSTEM MODIFICATION (TAILORING) PROCEDURES 


The software package supplied to each user is a general purpose ver- 
sion of the DOS-15 Software System] This means that the system con- 
tains all of the standard DOS-15 language programs, utility programs, 
library routines, and I/O device handling routines supported by 
Digital Equipment Corporation. Included as a part of this general 
package is a utility program called the System Generator (or SGEN ) . 
SGEN enables the user to tailor the| DOS-15 software to suit the 
particular hardware configuration and operating requirements of his 
installation. 


Specifically, SGEN provides the user with the ability to: (1) delete 
system programs or add his own 1 ; (2) add and delete I/O device hand- 
lers; (3) add and delete system library routines; (4) alter system 
load-time parameters puch as: I/O device assignments, teleprinter 
model currently being used, availability of an extra memory page, 
number of buffers to be allocated, file and directory protection 
codes, etc.; (5) change system operating parameters including: the 
Priority Interrupt Skip Chain, number of positive .DAT slots, the 
presence of 7- or 9-channel Magtape drives, the Monitor Identification 
Code (MIC) . 


described in the DOS -15 System Manual (DEC-15-NRDA-D) and 
the System Generator Utility Program Manual (DEC-15-YWZB-DN12) . 
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CHAPTER 8 


KEYBOARD COMMANDS 


8.1 INTRODUCTION 

This chapter describes the commands which can be issued from the con- 
sole keyboard to direct the operations of the DOS-15 system software. 

In communicating with the Monitor, the keyboard of the console tele- 
printer is used as the system's control device. The operator at the 
keyboard types commands to allocate system resources , load and start 
system and user-created programs, terminate program operation, and ex- 
change information with the Monitor. Most of the Monitor's keyboard 
commands are issued prior to loading system or user programs and are 
interpreted by the Nonresident Monitor. 

During program execution, a small set of keyboard commands is avail- 
able for general program control. These commands are interpreted by 
the teleprinter's I/O device handler (which is part of the Resident 
Monitor) , and are used to control program start and restart, dumping 
of core, and the reloading of the Nonresident Monitor. Paragraph 8.11 
describes commands used during program execution. 

The console teleprinter is the communications interface between the 
user-operator and the Monitor. The interaction between the operator 
and the Nonresident Monitor is completely conversational. Each com- 
mand issued causes the Monitor to type out an appropriate reply. 

Monitor responses may vary from a single character to several pages 
of information. 

In the context of this manual, the term "console keyboard" designates 
any one of several keyboard/printer/display I/O devices which could be 
used by the Monitor as the system command console device. (That is, 
it is associated with .DAT slots -2 and -3). Generally, a Model 33 
or 35 teleprinter is used. 

The keyboard commands are, however, not strictly limited to input from 
the keyboard. The Monitor can be operated in a Command Batching Mode 
(see 8.12) in which keyboard commands can be issued from either punched 
cards or paper tape with minimum operator intervention. Similarly, 
the Monitor's responses to commands are not strictly limited to a key- 
board device's printer or display, but may also be output to other 
devices including the VT15 Display or a line printer, when available. 
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8 . 2 KEYBOARD COMMAND FORMATS AND CHARACTERS 


8.2.1 Keyboard Command Elements 

All keyboard commands, except those using the keyboard CTRL key, consist 
of at least two elements, a command name and a terminator. Some com- 
mands require an additional third element consisting of one or more 
arguments inserted between the command name and the terminator. Each 
command name is separated from its argument (or argument string) by one 
or more spaces. Delimiters between multiple arguments vary, and are 
specified in the descriptions for the individual commands. Except as 
otherwise specified, each command string can be terminated by either a 
Carriage RETURN or an ALT MODE. CTRL commands are formed by simultane- 
ously depressing the keyboard's CTRL key and letter key, and are inter- 
preted by the Resident Monitor. These commands need no terminators, 
such as Carriage RETURN or ALT MODE. They are interpreted immediately 
after they have been typed. Once typed, the command is echoed in the 
form of an up-arrow (+) followed by the letter which identifies the com- 
mand. Thus, CTRL C is echoed +C. 

The symbols defined in the introduction to Chapter 5 are used in illus- 
trating the command formats described in the succeeding paragraphs of 
this chapter. DOS-15 system programs accept ASCII characters shown in 
Appendix A. 

8.2.2 Editing Features 

The teleprinter's device handler provides two keyboard editing functions 
which can be used to change the line currently being typed (prior to 
typing Carriage RETURN or ALT MODE) . 

RUBOUT The RUBOUT key permits successive deletion of characters, 
starting with the last character typed. Each RUBOUT 
deletes one character and causes a backslash (\) to be 
echoed in response. RUBOUT does not delete characters 
past the previous line terminator. Once all characters 
in a line have been deleted, additional RUBOUTs are 
ignored. For example, if the command INSTRUCT were mis- 
typed as INSTRUTC, it could be corrected by typing two 
RUBOUTs followed by CT , as shown below: 

Example : 

? INSTRUTC \\CT 

CTRL U Formed by depressing the CTRL key and striking the U key, 
this command during input eliminates all characters typed 
up to the last Carriage RETURN or ALT MODE and echoes 
a @. Thus an irretrievably bollixed input line may be 
eliminated (before typing Carriage RETURN or ALT MODE) 
by typing CTRL U. This feature can also be used during 
output to abort the current line. 
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8.2.3 When to Issue Keyboard Commands 


All keyboard commands, except for the CTRL commands (see 8.11) are 
only recognized and accepted when the Nonresident Monitor is in core, 
as evidenced by the appearance of either of the following identifiers 
on the teleprinter: 

DOS-15 Vnn where: Vnn = version number 

$ 

or 

$ 

The operator can obtain the Nonresident Monitor by typing CTRL C, (de- 
scribed in 8.11.1). When the Monitor is initialized using the Boot- 
strap, or by typing CTRL C, the full identification is typed. At all 
other times it indicates its readiness to accept keyboard commands by 
simply typing the dollar sign ($) . Once the $ is typed, the Monitor 
idles until the operator types a command. 

8.3 COMMANDS TO REQUEST SYSTEM INFORMATION 

The commands in this paragraph provide the user with various lists 
of system information. The lists include: (1) general system in- 
formation, (2) keyboard commands, (3) error messages, and (4) .DAT 
slot assignments. Since these lists tendtobe lengthy, users who 
have either a line printer or a VT-15 Display can speed up the output 
of this information by using the special line printer and VT-15 com- 
mands (described in paragraphs 8.9 and 8.8, respectively). 

8.3.1 SCOM 


The SCOM command causes the typeout of DOS-15 system information. 

The information includes (1) available I/O device handlers, (2) sys- 
tem default parameters, (3) important core addresses, and (4) the 
Priority Interrupt Skip Chain order. 

Form: SlCOM]^ 
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Example : 
$S 


SYSTEM INFO - DOS-15 - 1 1/02/71 

77646 - BOOTSTRAP RESTART ADDR 

77636 - 1ST FREE CELL BELOW BOOTSTRAP 

2722- ADDR OF .DAT 

2760- ADDR OF .UFD 

20 - NO. OF POS. .DAT SLOTS 

SYSTEM HAS API 

SYSTEM HAS EAE 

PAGE MODE OPERATION 

7 CHANNEL MAGTAPE ASSUMED BY HANDLERS 
80-CHARACTER LINE PRINTER ASSUMED BY HANDLERS 

2 - DEFAULT FILE PROTECTION CODE 

03 - DEFAULT BUFFS SETTING 
1274- tQ ADDRESS FOP MANUAL DUMP 
I/J HANDLERS AVAILABLE 

TTA TELETYPE: I/O, ASCII MODES, ALL FUNCTIONS 

PRA TAPE READER: INPUT, ALL MODES, ALL FUNCTIONS 

PRB TAPE READER: INPUT, IOPS ASCII MODE, ALL FUNCTIONS 

PPA PUNCH: OUTPUT, ALL MODES, ALL FUNCTIONS 

PPP PUNCH: OUTPUT ,ALL MODES LESS IOPS ASCII, ALL FUNCTIONS 

PPC PUNCH: OUTPUT, IOPS BINARY MODE, ALL FUNCTIONS 

DTA DECTAPE: 3 FILES, I/O, ALL MODES, ALL FUNCTIONS 

DTC DECTAPE: 1 FILE, INPUT, IOPS MODES, LIM FUNCTIONS 

DTD DECTAPE: 1 FILE, I/O, ALL MODES, ALL FUNCTIONS 

DTE DECTAPE: 1 FILE, I/O, ALL MODES, NO .MTAPE 

DTF DECTAPE: NON-FILE ORIENTED FOR F4 .OTS 

DKA DECDISK: N FILES, I/O, ALL MODES, ALL FUNCTIONS 

DKB DECDISK: N FILES, I/O, ALL MODES, LIM FUNCTIONS 

DKC DECDISK: N FILES, INPUT, ALL MODES, LIM FUNCTIONS 

DPA DISKPACK: N FILES, I/O, ALL MODES, ALL FUNCTIONS 

DPB DISKPACK: N FILES, I/O, ALL MODES, LIM FUNCTIONS 

DPC DISKPACK: N FILES, INPUT, ALL MODES, LIM FUNCTIONS 

LPA LINE PRINTER: OUTPUT, ASCII MODES, ALL FUNCTIONS 

CDB CARD READER; INPUT, IOPS ASCII MODE, ALL FUNCTIONS 

VTA VT-15: I/O 

LKA LK-35 KEYPOAPD: INPUT, ASCII MODES, ALL FUNCTIONS 
SKIP CHAIN ORDFR 
SPFAL 
DTDF 
DSSF 
DPSJ 
SPDI 
W1SK 
FCSF 
RCSD 
CLSF 
LSDF 
RSF 
PSF 
KSF 
SPKF 
TSF 
DTEF 
DPSE 
MPSNE 
MPSK 
SPE 
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8.3.2 INSTRUCT 


The INSTRUCT command causes a typeout of either the keyboard commands 
or system errors, depending upon which form of the command is used. 

Form 1: I[NSTRUCT]^ 

Example : 

SI 


DOS- 15 COMMANDS! 

LOG (L) : USER COMMENTS TERMINATED BY ALTMODE 

LOGW: USER COMMENTS TERMINATED BY ALTMODE, WAIT FOP tp TO CONTINUE 

DATE (D) • ECHO DATE 

DATE(D) MM/DD/YY: ENTER DATE 

TIME ( T) : ECHO TIME 

TIME(T) HHMMs ENTER TIME 

PPOTECT (P) Nr CHANGE DEFAULT PROTECTION CODE TO N 

KEEP (K) ON/OFF: KEEP .DAT SLOTS UNALTERED ON .EXIT 

LOGIN UIC: DEFINE NEW CURRENT UIC 

LOGOUT: SIGN OFF UIC 

ROSS 1 5: ENTER BOSS15 BATCH MODE 

SCOM ( S) r SYSTEM INFO 

I NSTRUCT (I) ! LIST OF MONITOR COMMANDS 

INSTRUCT(I) ERRORS: DESCRIPTION OF ERROR CODES 

REQUEST (R) , REQUEST (R) PRGNAM! .DAT SLOT USAGE 

REQUEST (R) USERr POSITIVE .DAT SLOT USAGE 

ASSIGN(A) DEVN <UIC* A ,B, . . ./ETC . ! .DAT SLOT MODS 

QDUMP(Q)! SET TO SAVE CORE (tQ) ON .IOPS ERROR 

HALT (H) ! SET TO HALT ON .IOPS ERROR 

tQNi SAVE CORE ON UNIT N 

GET ( G) r RESTORE CORE FROM tQ AREA 

GETP : RESTORE CORE FROM tQ AREA AND RESTART WITH tp 

GETT ! RESTORE CORE FROM tQ AREA AND RESTART WITH tT 

GETS ! RESTORE CORE FROM tQ AREA AND RESTART WITH tS 

GET ( G) N FILE ! RESTORE CORE FROM FILE ON UNIT N AND RESTART 

GETP N FILE • RESTORE CORE FROM FILE (UNIT N) AND RESTART WITH tp 

GETT N FILE t RESTORE CORE FROM FILE ON UNIT N AND RESTART WITH tT 

GETS N FILE : RESTORE CORE FROM FILE ON UNIT N AND RESTART WITH tS 

PUT N FILENM : PUT tQ AREA INTO FILENM ON UNIT N 

API ON/OFF! CHANGE STATE OF API 

VT ON/OFF: TURN GRAPHIC DISPLAY ON/OFF 

HALF ON/OFF! TURN HALF BUFFER MODE FOR GRAPHIC DISPLAY ON/OFF 
33 TTY ON/OFFr CHANGE STATE OF TELETYPE 

LP ON/OFF! TURN ON/OFF LINE PRINTER FOR OUTPUT OF SOME NPM COMMAND' 

X4K ON/OFFr CHANGE STATE OF EX TP A AY CORE CONFIGURATIONS 

BANK ON/OFF: CHANGE STATUS OF RANK MODE 

PAGE ON/OFF! CHANGE STATUS OF PAGE MODE 

PUFFS N: CHANGE DEFAULT BUFFER ALLOCATION 

CHANNEL 7/9! SETUP DEFAULT ASSUMPTION FOR MAGTAPE 

t C: RESTORE DOS-15 tPr USER RESTART tTr RESTART DDT 

tX! TURN VT ON OR OFF 
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DOS-15 PROG LOADING COMMANDS AND PROGNAM FOR REQUEST COMMAND 
LOAD: LINK LOAD AND WAIT FOR tS 
GLOAD: LINK LOAD AND GO 

DDT: LINK LOAD WITH SYMBOLS AND GO TO DDT 
DDTNS: LINK LOAD W/O SYMBOLS AND GO TO DDT 
MACRO: SYMBOLIC MACRO ASSEMBLER 
F4: FORTRAN IV COMPILER 
EDIT: TEXT EDITOR 
PIP: PERIPHERAL INTERCHANGE PROG 
SGEN: SYSTEM GENERATOR 
DUMP: BULK STOR DEV DUMP 
UPDATE: LIBR FILE UPDATE 
SPCCOM: SOURCE COMPARE 
EDITVP: STORAGE SCOPE EDITOR 
EDITVT; GRAPHIC DISPLAY (VT> EDITOR 
PATCH: SYSTEM TAPE PATCH ROUTINE 
EXECUTECE) FILE; LOAD AND RUN FILE XCT 
CHAIN: XCT CHAIN BUILDER 
8TRAN: PDP-8 TO PDP-15 TRANSLATOR 
89 TRAN: PDP-8 TO PDP-9 TRANSLATOR 
MTDUMP: MAG-TAPE UTILITY PROGRAM 
DTCOPY: DECTAPE COPY PROGRAM 
DOS-15: BATCH 

BATCH (B) DV: ENTER RATCH MODE WITH DV AS BATCH DEV 
DV: PR r PAPER TAPE READER 
CD = CARD READER 

$JOR: CONTROL COMMAND WHICH SEPARATES JOBS 

5DATA: BEGINNING OF DATA 

SEND: END OF DATA 

SPAUSE; WAIT FOR tp ON TTY 

$EXIT: LEAVE BATCH MODE 

TT: SKIP TO NEXT JOB 

tC: LEAVE BATCH MODE 

tP: CONTINUE FROM SPAUSE 


Form 2: INSTRUCT] ERROR[S]/ 


Example : 


$1 ERRORS 


DOS-15 - .IOPS 

0 ILL FUNCTION CAL - CAL ADDR 

1 CAL* ILL - CAL ADDR 

2 .DAT SLOT ERROR - CAL ADDR 

3 ILL INTERRUPT - I/O STATUS REGISTER 

4 DEV NOT READY - TYPE tR WHEN READY * 

5 ILL .SETUP CAL - CAL ADDR 

6 ILL HANDLER FUNCTION - CAL ADDR * 

7 ILL DATA MODE - CAL ADDR * 

10 FILE STILL ACTIVE - CAL ADDR ** 

11 SEEK/ENTER NOT EXECUTED - CAL ADDR * 

12 HNRF.COVERARLE DEVICE ERROR - STATUS REG B AND UNIT NO. 
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13 FILE NOT FOUND - CAL ADDR ** 

14 DIRECTORY FULL - CAL ADDR 

15 DEVICE FULL - CAL ADDR ** 

IS OUTPUT RUFFER OVERFLOW - CAL ADDR 
17 TOO MANY FILES FOR HANDLER - CAL ADDR * 

20 DISK FAILURE ( CTRLR TO RETRY) - DISK STATUS, BLK #, DEVICE/UNIT #,UIC 

21 ILL DISK ADDR - BLOCK NO, DEVI CE/UNI T NO, CAL FUNCTION, UIC 

22 TWO OUTPUT FILES ON ONE DECTAPE UNIT - CAL ADDR 

23 ILL WORD PAIR COUNT - CAL ADDR ** 

30 API SOFTWARE LEVEL ERROR - API STATUS REG 

31 NON-EXISTENT MEMORY REF - PC 

32 MEMORY PROTECT VIOLATION - PC 

33 MEMORY PARITY ERROR - PC 

34 POWER FAIL SKIP NOT SETUP - PC 
37 LINE OVFLO - CAL ADDR 

40 HEADER LAREL ERROR - CAL ADDR 

41 DIRECTORY FORMAT ERROR - CAL ADDR 

42 ACCESSIBILITY MAP OVFLO - CAL ADDR 

43 DIRECTORY RECORDING ERROR - CAL ADDR 

44 LOGICAL EOT FOUND - CAL ADDR 

45 LONG INPUT RECORD - CAL ADDR 

46 ATTEMPT TO DELETE SYSTEM FILE - CAL ADDR 

47 ILL HORIZONTAL TAB - CAL ADDR 

51 ILLEGAL USER FILE DIRECTORY - CAL ADDR ** 

55 NO BUFFERS AVAILABLE - CAL ADDR * 

61 PARITY ERROR IN DIRECTORY OR FILE BIT MAP - CAL ADDR * 

63 PROTECTED USER FILE DIRECTORY - CAL ADDR * 

64 PROTECTED FILE - CAL ADDR ** 

65 UNRECOVERABLE MAGTAPE ERROR - MT STATUS 

66 RELATIVE BLOCK IS 0 OR NOT WITHIN FILE SCOPE C.RTRAN) ** 

67 .RTRAN ARGUMENTS CAUSE DATA BLOCK OVERFLOW - CAL ADDR ** 

70 BUFFER SIZE TOO SMALL - CAL ADDR * 

71 EMPTY UIC ** 

72 INPUT PARITY OR WRITE CHECK ERROR ( TR TO RETRY) 

- CALADDR, BLOCK NO, DEVICE/UNIT NO, CAL FUNCTION, UIC 

73 NULL FILE NAME GIVEN ON SEEK/ENTER/DLETE/FSTAT/RAND * 

74 FILE STRUCTURE DEGRADATION - ATTEMPT TO CLEAR SUBMAP 
BIT THAT WAS ALREADY OFF ** 

75 FILE STRUCTURE DEGRADATION - ILLEGAL SUBMAP WORD1 

76 FILE STRUCTURE DEGRADATION - ILLEGAL BACKWARD POINTER FOR FIRST 
MFD OR UFD BLOCK < TR TO RETRY) 

77 ATTEMPTED USE OF NON-EXISTANT TQ AREA 


* DISK ONLY* 

CAL ADDR, DEVICE AND UNIT NO.,CAL FUNCTION, UIC 
** DISK ONLY: 

CAL ADDR .DEVICE AND UNIT NO., CAL FUNCTI ON ,UI C , FILE NAME 
LOADER ERRORS - .LOAD OR . SYSLD 

1 MEMORY OVERFLOW 

2 DATA ERROR 

3 SUBR NOT FOUND 

4 .DAT SLOT ASSIGNMENT ERROR 

5 PROG SEGMENT GREATER THAN 4K (PAGE MODE) 

OBJECT TIME SYSTEM ERRORS - .OTS 

5 ILL REAL SQUARE ROOT ARG 

6 ILL DOUBLE SQUARE ROOT ARG 

7 ILL INDEX IN COMPUTED GOTO 

10 ILL I/O DEV * 

11 ILL INPUT DATA 

12 ILL FORMAT STATEMENT 

13 Il.L REAL LOG ARG 
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14 ILL DOUBLE LOG ARG 

15 Z EFO RAISED TO ZEPO OR NEGATIVE POWER 

21 UNDEFINED FILE 

22 ILLEGAL RECORD SI7E 

23 SIZE DISCREPANCY 

24 ILLEGAL RECORD NUMBER 

25 MODE DISCREPANCY 

26 TOO MANY OPEN FILES 

30 SINGLE INTEGER OVERFLOW 

31 EXTENDED (DOUBLE) INTEGER OVERFLOW 

32 SINGLE FLT. OVERFLOW 

33 DOUBLE FLT. OVERFLOW 

34 SINGLE FLT. UNDERFLOW 

35 DOUBLE FLT. UNDERFLOW 

36 FLT. DIVIDE CHECK 

37 INTEGER DIVIDE CHECK 

40 ILLEGAL CHARACTER COUNT 

41 ARRAY EXCEEDED 

42 BAD INPUT DATA 

50 EPP MEMORY PROTECT/NON-EXISTANT MEMORY VIOLATION 

51 ILLEGAL I/O DIRECTION CHANGE TO DISK 


8.3.3 REQUEST 

The REQUEST command causes a typeout of the I/O Device Handlers cur- 
rently associated with the slots of the Monitor's Device Assignment 
Table (.DAT). Since this command is closely related to the commands 
which affect I/O device assignments, it is described in paragraph 
8.5.1. 

8.4 COMMANDS RELATED TO FILE PROTECTION 

8.4.1 LOGIN 

This command permits the operator to enter his User Identification 
Code (UIC) into the system in order to do director ied disk. I/O. 

After a LOGIN, the Nonresident Monitor sets the slots of the User File 
Directory Table (UFDT) to the three-character code entered. All input/ 
output operations to the disk are directed to the UFD associated with 
the last UIC entered by this command, unless a program has subsequently 
executed a .USER I/O Macro, or the operator has issued an ASSIGN 
command (see 8.5.2). 
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Each LOGIN command issued enters a new UIC into the system and auto- 

plicit LOGOUT (see LOGOUT, in paragraph 8.4.4). A UIC must consist 
of exactly three alphanumeric characters in any combination except 
"@@@", "???", "PAG", "BNK" , "SYS", "IOS" and "CTP". 

Form: LOGIN,_jUic^ 

where: uic = User Identification Code 

8.4.2 MICLOG 

This command permits the Monitor Identification Code (MIC) to be 

-fc> u r W\ t 

entered into the system. This provides the operator with unrestricted 
access to all files contained in the various directories on the disk 
and permits the system programs SGEN and PATCH to be used to modify 
the system. The MIC of each system, as initially supplied to the user, 
is "SYS". As with LOGIN, a MICLOG entry is deleted from the system 
by the LOGOUT or LOGIN commands. The MIC is usually known only by 
the system owner, and the code is easily changed at system generation. 

Form: MICLOGi__imic^ 

where: mic = Monitor Identification Code 


8.4.3 PROTECT 

The PROTECT command is used to alter the default value of the file 
protection code, set when the system was generated (by the SGEN 
program) . The default file protection codes set by this command 
remain in effect until another PROTECT command is given or until the 
user issues a LOGIN or LOGOUT (which resets the protection code to 
the system's default value). Refer to 4.7.3 for a list of these codes. 

Form: P[ROTECT]. .nj 

where: n = Protection Code 

8.4.4 LOGOUT 

This command deletes the current UIC or MIC entry from the System. 
LOGOUT also resets all system parameters affected by keyboard commands 
to their default status. These parameters include: 
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a. 


.DAT and .UFDT assignments (ASSIGN command) 


b. Commands which take an "ON/OFF" argument, such as: 
KEEP, X4K, 33TTY, HALF, LP , PAGE/BANK, API, and VT. 

c. Commands which take a numeric argument, including: 
CHANNEL, PROTECT, and BUFFS. 


Form: LOGOUT j 

8.5 COMMANDS DEALING WITH I/O DEVICE ASSIGNMENTS 
8.5.1 REQUEST 


This command causes a typeout of the I/O devices currently associated 
with the slots of the Monitor's Device Assignment Table (.DAT) and 
the UIC's associated with the User File Directory Table (.UFDT). The 
command can be issued using various arguments which result in a complete 
printout of the assignments or selected portions thereof. If REQUEST 
is issued with no argument, the entire .DAT/. UFDT list of assign- 
ments is output. If the argument USER is inserted, only the positive 
(user) .DAT and associated .UFDT assignments are output. If an argu- 
ment which is a legal system program name is used (e.g., MACRO, PIP, 
etc.), only the assignments for that program are output. 

Form: R[EQUEST]^[j^ERj ; 

"prog" may be any of the following: 


MACRO 

F4 

FOCAL 

PATCH 

DTCOPY 

GLOAD 

LOAD 

DUMP 

MTDUMP 

UPDATE 

PIP 


EDIT 

EDITVP 

EDITVT 

SGEN 

SRCCOM 

CHAIN 

EXECUTE 

8TRAl| 

8 9 TRAN 
DDT ! 
DDTNS 


Examples : 

$R 


.DAT 

DEVICE 

UIC 

-15 

DKA 

SCR 

-14 

DKA 

SCR 

-13 

DKA 

SCR 

-12 

LPA 

SCR 


8-10 



-11 

DKA 

SCR 

-10 

TTA 

SCR 

-7 

DKL 

SYS 

-6 

DKA 

SCR 

-5 

NON 

SCR 

-4 

DKA 

SCR 

-3 

TTA 

SCR 

-2 

TTA 

SCR 

-1 

DKA 

SYS 

+ 1 

DKA 

SCR 

+2 

DKA 

SCR 

+3 

DKA 

SCR 

+4 

TTA 

SCR 

+ 5 

PRA 

SCR 

+6 

PPA 

SCR 

+7 

DTA 1 

SCR 

+ 10 

VTA 

SCR 

+ 11 

NON 

SCR 

+ 12 

DTA2 

SCR 

+ 13 

NON 

SCR 

+ 14 

NON 

SCR 

+ 15 

NON 

SCR 

+ 16 

NON 

SCR 

+ 17 

NON 

SCR 

+20 

NON 

SCR 


Example 2: 


$R USER 


.DAT 

DEVICE 

UIC 

+ 1 

DKA 

SCR 

+2 

DKA 

SCR 

+3 

DKA 

SCR 

+4 

TTA 

SCR 

+5 

PRA 

SCR 

+6 

PPA 

SCR 

+7 

DTA 1 

SCR 

+ 10 

VTA 

SCR 

+ 1 1 

NON 

SCR 

+ 12 

DTA2 

SCR 

+ 13 

NON 

SCR 

+ 14 

NON 

SCR 

+ 15 

NON 

SCR 

+ 16 

NON 

SCR 

+ 17 

NON 

SCR 

+20 

NON 

SCR 


Example 3: 

$R MACRO 


.DAT 

DEVICE 

UIC 

USE 

-14 

DKA 

SCR 

INPUT 

-13 

DKA 

SCR 

OUTPUT 

-12 

LPA 

SCR 

LISTING 

-1 1 

DKA 

SCR 

INPUT 

-10 

TTA 

SCR 

SECONDARY 


INPUT 
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8.5.2 ASSIGN 


This command permits the temporary reassignment of the various slots 
of the Monitor's Device Assignment Table (.DAT) to I/O device handlers 
other than those permanently assigned at system generation. In addi- 
tion, the corresponding slots of the User File Directory Table (.UFDT) 
can also be reassigned to UIC's other than the UIC which is currently 
in effect. Unless the KEEP command is issued, the change of assign- 
ment is effective only fo r the current job (i.e. , the program about to 
be run) , since the permanent assignments are restored when the Nonresi- 
dent Monitor regains control (i.e., after the current job has terminated). 
The KEEP command (described below) can be used to retain assignments 
from job to job. 


Prior to using ASSIGN, the user should be familiar with the various 
handlers which can be used with the program for which the assignments 
are to be made. Chapter 9 describes the handlers in the system. A 
list of the handlers available on any given system can be obtained in 
the printout obtained with the SCOM command. The following rules should 
be observed when typing ASSIGN commands: 


a. Device handler names consist of three characters which 
can be abbreviated to two characters if the last char- 
acter is an "A". Thus, "DkA" becomes "DK" . In addi- 
tion, a number can be typed as a fourth character to 
specify the device unit number (in octal) . The 

unit number is applicable for devices which can have 
more than one unit: Disk Pack, DECtape, and Magtape. 

If the unit number is zero,, it need not be specified. 
Thus, "DTAj3" becomes simply "DT" , similarly, "DPB fl" 
can be typed as "DPB". "DTAl" may be typed as "DTI". 

b. .DAT/. UFDT slot numbers (octal) must be within the legal 
range for the particular system being used. Since the 
number of negative slots does not change (-15 is the 
lowest negative slot), the user need only be concerned 
with the number of positive slots available. This can 
be determined either from a SCOM or a REQUEST USER com- 
mand . 

c. A series of assignments can be typed on the same line, 
using a single ASSIGN command, by separating the as- 
signments with a slash (/) , The user can then type 
another device name, UIC, and slot number (s). (See 

ex amp 1 es be low . ) 

d. Assigning NON instead of a device handler name will 
assign a null handler to .DAT slots that are not 
needed. This will save core since no handler will 
be loaded at run time. 
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f <uic> 

Form: A[SSIGN] ,Jdev < ulcA. . af .b.c.etc. 1 J 

^"^\dev ' 

|NON 

where : 

uic = legal User Identification Code 
dev = Device Handler name and unit (if applicable) 
a,b,c,etc. = Legal slot numbers 
NON = No device handler 
Examples : 

1. To assign the teleprinter to .DAT slot -11 and the 
paper reader (version A) to .DAT slot 14, type: 

AkjTTu-li; 

AujPRfc.,14 ) 

or 

AwjTT^-II / RR VJ 14^ 

2. To assign UFD "ABC" to .UFDT slot -14, and the Disk Pack and 
UFD "TRE" to .UFDT slot 10, type: 

A t _,< ABC>i_,-14 / DtujCTREi'wlUJ 

3. To assign the Disk Pack to several .DAT slots, tvpe: 

A4-iWi-il,2,3,15J 

8.5.3 KEEP ON/OFF 

This command instructs the Monitor either to retain or reset .DAT/. UFDT 
slot assignments after the current program (for which the assignments 
were made) terminates execution and control returns to the Monitor. 

"ON" retains assignments and "OFF" allows them to be reset. When a 
LOGOUT command is issued, the "OFF" parameter is automatically set. 

Form: K[EEP),_ J { J 

8.6 CORE ALLOCATION COMMANDS 
8.6.1 BUFFS 

This command temporarily changes the parameter which specifies the 
default value for the number of buffers available in the Monitor's 
buffer pool for disk I/O and for the .GVBUF and . GTBUF Monitor Com- 
mands. The default value is restored whenever the Nonresident Monitor 
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returns. This value is set during system generation along with the 
actual size of the buffers to be allocated (the default values for 
systems as initially distributed are: Number of Buffers = 3, Buffer 
Size = 5 / 30 q } . 

The user should exercise care when issuing this command, since the DEC- 
disk and Disk Pack device handlers and the DECtape "A" handler obtain 
the buffers required for their operation from this pool. One of these 
buffers is required for each opened file. Terminal errors result 
when an insufficient number of buffers is available. Alternatively, 
program loading errors occur when the number of buffers allocated 
results in an insufficient amount of core for program loading. When 
requesting system programs, the user need not be concerned about buf- 
fer availability since each system program has its own default param- 
eter for the maximum number of buffers required (e.g., MACRO has 3, 

EDIT has 2. ) . 

Form: BUFFSun^ 

where: n = number of buffers (decimal radix) desired. 

8.6.2 X4K ON/OFF 

This command informs the Monitor of the availability of a page (4K) 
of memory in systems which have an odd number of memory pages (i.e., 

20K and 28K systems) . The additional core space, when specified as 
available, is used for loading system and user programs. 

Form: X [ 4K] 1 _,{ °£ p } ) 

8.7 CORE IMAGE SAVE/RESTORE COMMANDS 

The commands described in this section provide facilities for. saving 
and restoring the entire image of core. These commands can be used to 
advantage not only for obtaining "snapshots" of core for debugging 
purposes, but also for rapid loading of commonly used programs, parti- 
cularly user-created programs whi ch use many library routines . 

These commands work in conjunction with a reserved area on the DECdisk 
and each Disk Pack called the Save Area, or QAREA. The QAREA is a 
temporary storage area into which a core image may be dumped and from 
which core images are restored. This is considered a temporary storage 


8-14 



area since each time a command to dump core is given, the previous 

contents of this area are lost. Additional commands are therefore 

supplied, to permit users to create named files of core 

images in the QAREA. Such files can be used for permanent storage 

and can be restored to core via Keyboard commands. The DUMP 

program can be used to obtain listings of core dumped into the QAREA. 

8.7.1 CTRL Q 

This command interrupts the program currently running, dumps the en- 
tire contents of core into the QAREA of the system device and returns 
control to the Nonresident Monitor. Users with Disk Packs 
must specify on which unit the dump is to take place. The 
command is typed by simultaneously depressing the CTRL and Q keys 
on the keyboard. Upon receipt of the command, the Monitor echoes an 
+Q . (If no echo occurs, no QAREA exists on the device, or the system 
has crashed.) If the system device is Disk Pack, the Monitor waits 
for the user to type a unit number before processing, otherwise pro- 
cessing continues automatically, core is dumped into the QAREA and the 
Monitor regains control as shown below. 

Form: CTRL Q 

Response: fQn 

DOS -15 Vnn 

$ 

where: n = Disk Pack Unit Number ( 0 - 7 ) 

8.7.2 QDUMP 

This command instructs the Monitor to automatically execute a CTRL Q 
command (see above) when a terminal IOPS error is detected. IOPS 
errors are listed in Appendix D. 

Form: Q [DUMP] 

8.7.3 PUT 

This command instructs the Nonresident Monitor to create a file, 
which is a copy of the current contents of the specified QAREA, on 
the device associated with .DAT slot -14. If the system device is 
Disk Pack, a unit number can be specified, otherwise 0 is assumed. 

The user must type a file name which may consist of up to six charac- 
ters and a three character extension. 
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Form: PUT [, , n], , f ilnam^ext^ 

where: 

n = Disk Pack Unit Number (0- 7) , 0 assumed if not specified 

filnam = File Name (1-6 characters) 

ext = Required filename extension (1-3 characters) 

8.7.4 GET 


This command instructs the Monitor to restore (to core) a core image 
residing either in the QAREA of the system device, or on the device 
associated with .DAT- slot -14 as a named file (i.e., created by a PUT 
command) . No name with the command gives the first option. If the 
use 1 : supplies a name, the second option (.DAT -14) will be taken. 

Execution of the restored core image is resumed by one of the Program 

Start/Pestart Commands described in Paragraph 8.11 (CTRL P, CTRL T, 
or CTRL S) . These commands can be issued either manually from the 
keyboard or automatically by argument in the GET command string. 

When a restored core image is to be restarted 
manually (i.e., by typing CTRL P, CTRL T, or 
CTRL L) , the user should wait at least 8 sec- 
onds after issuing the GET to ensure the com- 

plete transfer of the core image before typing 
the command. 


When restoring a core image file from .DAT -14, the Monitor also 
places the core image in the QAREA of the system device- Disk Pack 
unit numbers other than zero must be specified in the command string. 
This permits the user to conveniently use the DUMP program to obtain 
listings of core image files. 


Form: GET ( 



] [^filnam ext] ^ 


where : 

P , T , S = Perform automatic program start 

P = CTRL. P start address 
T = CTRL T start address 
S = CTRL S start address 

Note that there must be no space between GET or G 
and P, T, or S. 

If not specified, appropriate CTRL character must 
be issued from the keyboard. 

n = System device unit number (0-7) of Disk Pack QAREA to 
be used. If not specified, 0 is assumed. 


8-16 



filnam ext = Name and extension of core image to be re- 
trieved from .DAT -14. If not specified, 
the contents of the QAREA are restored. 

Note: Since GET commands cause an entire core image 

to be brought in, all system conditions and 
parameters extant when core was dumped are 
restored. This includes the DATE and TIME 
.SCOM registers. 

Examples : 

1. Restore the QAREA of the DECdisk or Disk Pack unit 0: 

type: GET \ 

or G^ 

2. Restore a core image file called DMPFIL 001 and auto- 
matically start at the CTRL P address: 

type: GETP u-J DMPFIL u j301^ 

3. Restore a core image file called DMPFIL 002, placing 
the core image in the QAREA of Disk Pack unit 3: 

type: GET. .3»_iDMPFIL»— .002 . 

Notice that a manual start must be performed, since 
P, T or S was not specified with the GET. 


8.8. VT15 DISPLAY COMMANDS 

The commands described in this section provide users who have configu- 
rations which include a VT15 Display Processor and a VT04 Display Con- 
sole with the ability to display any text normally directed to the 
teleprinter on the screen of the VT04 Display Console. The control 
commands are issued from the teleprinter keyboard and permit rapid 
switching between hard and soft copy output when operating with either 
the Monitor, system programs, or user programs. Up to fifty-six 72- 
character lines can be displayed. Keyboard input is echoed both on 
the display (when ON) and the teleprinter. When operated in this 
manner, the VT15/VT04 Display System functions as an extension of the 
teleprinter and communicates directly with its device handler. 1 

8.8.1 Operating Features 

8. 8. 1.1 Display Modes - Two modes of display are provided which are 
controlled by the two rightmost pushbuttons (#5 and #6) on the 

VT04 console. 


1 To operate the display as a separate I/O device, the user must use the 
software package described in GRAPHIC15 Programming Manual , DEC-15-ZFSA-D. 
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a. Continuous (Scroll) Mode - In this mode of operation, 
pushbutton #5 must be in the OFF position (i.e., not 
illuminated) . Each text line is displayed on the 
screen starting at the top and progressing to the 
bottom. When 56 lines have been displayed, or the 
display buffer is full (as with HALF 0N) f each addi- 
tional line causes all displayed lines to move up 
one line position and the top line to be deleted. 

b. Paging Mode - This mode of operation causes the dis- 
play to stop after 56 lines have been output, or 
the display buffer is full. The display will then 
wait for the user's signal. Paging Mode is entered 
by setting pushbutton #5 to the ON position (i.e., 
button #5 is illuminated) . The next display page is 
obtained by depressing pushbutton #6 once. 


8. 8. 1.2 Clearing the Display Screen - The display screen can be 
erased at any time by depressing pushbutton #6 once and typing a 
Carriage RETURN. 


8. 8. 1.3 Editing - Both single characters and entire lines can be 
deleted during input from the teleprinter keyboard using the standard 
keyboard editing commands RUBOUT and CTRL U. The only difference on 
the VT is that, when using RUBOUT, no backslash ( \ ) is echoed on 
the display; the unwanted character is simply deleted. 


8.8.2 Display Command Descriptions 

The following paragraphs describe the three keyboard commands required 
for operating the display. 

8. 8.2.1 VT ON/OFF - The ON argument of this command instructs the 
Monitor to load the routines which 'interface the VT15 to the tele- 
printer's device handler and set up the display buffer to the size 
specified by the HALF ON/OFF command (or its default setting). After 
this command has been typed, the user can switch at will between 
teleprinter and VT15 output using the CTRL X command described below. 
The routines and buffer space for display operation occupy either 
1234^ locations (when HALF is on) or 1923^ locations (when HALF is 
off). The OFF argument of this comtnand erases the display screen and 
releases the core area occupied by the display routines and display 
buffer. 

Form: VT^^jj 
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8. 8. 2. 2 HALF ON/OFF - This command is used to set the size of the 
display buffer. This, in turn, limits the maximum number of charac- 
ters which can be displayed on the VTJ34 screen. The OFF argument 
permits a full size buffer to be created. The full size buffer allows 
4032^ characters to be displayed (i.e., fifty-six 72-character lines). 

The ON argument allows only a half size display buffer to be loaded. 

A half size buffer allows 2016 characters to be displayed (e.g., 28 
72-character lines). Since most lines are not 72 characters long, 
more than 28 lines can usually be displayed with HALF ON. This feature 
is particularly useful during assembly or compiling operations when 
additional symbol table space is required. 

Form: HALF,_,{°p F y 

8. 8. 2.3 CTRL X - This command, formed by typing CTRL and X simul- 
taneously, alternately switches text output either to the teleprinter 
or to the VT04 screen. Once VT ON has been issued, CTRL X can be 
typed at any time (i.e., with the Monitor, a system program, or a 
user program) to change output control. An up-arrow ( i ) is echoed on 
the device to which control is transferred, 

8. 8. 2. 4 Command Default Settings - The commands VT ON/OFF and 
HALF ON/OFF can be initially set during system generation to meet 
user requirements. The default settings for the DOS-15 system as 
initially supplied are: VT OFF and HALF OFF. 

8.9 MISCELLANEOUS COMMANDS 

8.9.1 API ON/OFF 

This command controls the status of the Automatic Priority interrupt 
System for machine configurations having this option. The ON 
argument enables the API and the OFF argument disables the API. 

Form: APIc_,{™ p}j ) 
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8.9.2 3 3 TTY ON/OFF 


This command instructs the teleprinter device handler to operate with 
hardware configurations having either a Model 33 or Model 35 terminal 
as the system teleprinter. The ON argument specifies a Model 33 ter- 
minal and the OFF argument specifies a Model 35 terminal. 

Form: 33TTY ^ 

8.9.3 CHANNEL 7/9 

This command sets a constant in the Monitor which is used by the Mag- 
tape device handlers as the default operation parameter for 7- or 9- 
channel operation. Refer to the description of the Magtape handlers 
in Chapter 9 for further information. 

Form: C [HANNEL] w { g } ) 

8.9.4 LP ON/OFF 

This command permits the text output resulting from the System Informa- 
tion Commands REQUEST, REQUEST USER, INSTRUCT, INSTRUCT ERRORS, and 
INSTRUCT SCOM to be output to a line printer, if one is available- 
The ON argument directs output to the line printer and the OFF argu- 
ment restores output to the teleprinter. 

Form: LP^t™^ 

8.9.5 BANK ON/OFF - PAGE ON /OFF 

These commands permit the user to select either Bank or Page Mode 
operation. In Page Mode, relocatable system and user programs (in- 
cluding device handlers) are loaded within 4K memory pages, and Index 
Register usage is permitted. Library routines are loaded from the 
library residing in the PAG UFD. In Bank Mode, Index Register usage 
is not permitted, and user programs (including device handlers) 
are loaded within 8K memory banks, and system library routines 
are loaded from the library contained in the BNK UFD. Either BANK 
OFF or PAGE ON sets the system to operate in Page Mode. Conversely, 
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BANK ON or PAGE OFF sets the system to operate in Bank 
Mode. 


Form: BANK i _ | {°J f }^ or PAGE J 

8.9.6 OATE 

This command is used either to enter a calendar date or to examine 
the calendar date currently stored in the Monitor. This information 
is used by the system to indicate the date of creation of mass storage 
files. If no date has been entered into the system, each time con- 
trol is returned to the Monitor it outputs a message requesting that 
a date be entered. When a date is to be entered, the entire date 
(month, day and the last two digits of the year) must be typed. The 
DATE command with no argument causes the date currently stored in the 
Monitor to be typed out. 

Form: D [ATE] [ ^mml/] dd [/] yy ] J 

where : 

mm - Month (01-12) 

dd = Day of Month (01-31) 

yy = Year ('70-'99) 

If the slash delimiters (/) are used, leading zeroes can 
be omitted; otherwise all six digits must be typed. 

8.9.7 TIME 

This command is used either to enter or to examine the time of day 
currently stored in the Monitor. This information is updated by the 
Monitor every second. When time is to be entered, it must be typed 
as a 4-digit number (0000-2359) in 24-hour clock notation. The TIME 
command with no argument causes the current time of day (as kept in 
the Monitor) to be typed out. 

Form: T[IME][. .hhmm] J 

where : 

hh = Hours (00-23) 
mm = Minutes (00-59) 
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8.9.8 TIMEST 


This command instructs the Monitor to terminate the current operation 
and restart itself after a specified time interval has elapsed. The 
command is particularly applicable when operating in Command Batching 
Mode (discussed in 8.12 ), since it permits users to unconditionally 
terminate a program's operation if its execution time exceeds that 
value expected for normal operation. The time interval can be speci- 
fied in minutes, seconds, or a combination of both. The maximum time 
interval (total minutes and seconds) can not exceed 131,071 seconds. 
Once executed, a TIMEST command can only be nullified by a subsequent 
LOGIN or LOGOUT command. 

mm 

Form: TIMEST ^ mm:ss \ 

i*s s ^ 


Example: 


TIMEST : 5281 (5281 seconds) 
or 

TIMEST 88:1 (88 minutes, 1 second) 


where : 

mm = Minutes 
ss = Seconds 


8.9.9 LOG 


This command instructs the Monitor to ignore subsequent keyboard input 
and is used primarily for making operator comments. Typing ALT MODE 
restores the keyboard for normal command input. 

Form: L[OG] j 

comment 

comment ALT MODE 

8.9.10 HALT 

This command will cause the Monitor to halt computer operation after ter- 
minal I OPS errors. Press CONTINUE, followed by CTRL P or CTRL C to con- 
tinue system operation. 


Form: H [ALT] j 

8.9.11 CTRL D 


This command, formed by simultaneously striking the CTRL and D keys on 
the teleprinter keyboard, is used to indicate an end-of-file condition 
when the keyboard is used as an ordinary input device (as opposed to its 
being used as a command input device). CTRL D signals the teleprinter's 
device handler, or other keyboard device handler, if available, to 
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transmit a header word pair to the requesting program's I/O buffer in 
which bits 14-17 are set to the end-of-file code 01012 - Any informa- 
tion currently in the buffer is lost. In IOPS ASCII mode, therefore, 
a Carriage RETURN should always precede a CTRL D in order to assure 
output of the last line. 

8.10 SYSTEM PROGRAM LOADING COMMANDS 

The commands described in Table 8-1, System Program Loading Commands, 
are used to instruct the system loader within the Monitor to load the 
various language and utility programs which are part of the DOS-15 
Software System. Each command must be typed as shown, terminated by 
either a Carriage RETURN or ALT MODE. 

8.11 PROGRAM START/RESTART/CONTINUE COMMANDS 

The commands described below are used to provide keyboard control 
during system and user program operation. The format of these com- 
mands has been previously described in paragraph 8.2.1. 


8.11.1 CTRL C 

This command returns control to th® Nonresident Monitor. It can be 
typed at any time, signaling the Monitor that the user wishes to abort 
a program, or enter a keyboard command. In returning control to the 
Nonresident Monitor from a previously executing program, all device 
and UFD assignments are returned to their default settings unless the 
KEEP ON command is in effect (see 8.5.2 and 8.5.3). CTRL C can also 
be used to terminate the Monitor's processing of all keyboard commands 
except for TIMEST (see 8.9.8). In this case, device and UFD assign- 
ments are not affected. 

8.11.2 CTRL P 

This command restarts system programs, terminating current operation. 
Upon execution of this command, control is transferred to the 
start address specified in the last . INIT I/O Macro to the teleprinter. 
User programs may use this restart facility by issuing a . INIT macro 
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Table 8-1 


SYSTEM PROGRAM LOADING COMMANDS 


Command 

Program Loaded 

F 4 

FORTRAN IV compiler. 

MACRO 

MACRO-15 Assembler. 

EDIT 

Symbolic Text Editor. 

EDITVP 

Symbolic Text Editor for the VP15A Display. 

EDITVT 

Symbolic Text Editor for the VT15/VT04 Display System. 

LOAD 

Linking Loader (manual program start) 

GLOAD 

Linking Loader (load and go program start) 

PIP 

Peripheral Interchange Program. 

DDT 

Dynamic Debugging Technique Program 

DDTNS 

DDT program with no user symbol table loaded (i.e., 
octal number debugging) . 

DUMP 

Program to create listings of the contents of the 

QAREA (see 8.7). 

CHAIN 

Program to create a System of core overlays. 

E [XECUTE] 

Control program which supervises core residency during 
execution of a CHAIN-built overlay system. 

SRCCOM 

Source Compare Program (for comparing two ASCII files) . 

MTDUMP 

Magtape user's utility program. 

DTCOP* 

High-speed DECtape cdpy program. 

SGEN 1 

System Generator Program. 

PATCH 2 

Mass Storage Patching Program. 

UPDATE 

Program to create and update library files. 

8TRAN 

Program to translate PDP-8 code to PDP-15 code. 

8 9 TRAN 

Program to translate PDP-8 code to PDP-9 code. 

TKB 

- 

RSX15 Task building program. 3 

1 This program can only be run when the user is logged-in to the system 

with the MICLOG command. 

2 When this program is used with the system device, the user must be 

logged-in under the MIC. 

3 Refer to RSX15 Reference Manual (DEC-15-GRQA-D ) . 
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to .DAT-2 (which is permanently assigned to the teleprinter handler) . 
See 6.7.6 and the description of the teleprinter handler in Chapter 9. 
CTRL P is ignored until the teleprinter handler receives the proper 
. IN IT. 

8.11.3 CTRL S 

This command is used to start a program loaded by the Linking Loader 
via the LOAD command. 

8.11.4 CTRL T 

This command is used only with the DDT program and the Monitor's 
Command Batching Mode (see BATCH described below) . When used with 
DDT, CTRL T terminates execution of the program being debugged and 
causes DDT to enter command mode. When used with the Monitor's 
Command Batching Mode, it causes the current job to be terminated 
and a skip to the next job. 

8.11.5 CTRL R 

This command permits the user to continue program operation either 
after an I0PS4 (I/O device not ready) error occurs, or after the 
execution of a $PAUSE (see 8.12.3.4). Prior to typing this command, 
the user must first correct the condition which caused the error 
(e.g., DECtape unit incorrect, OFF LINE, etc.). 

8.12 BATCHING KEYBOARD COMMANDS 


Most of the Monitor's keyboard commands, as well as the keyboard com- 
mands for most system programs, can be issued from either the card 
reader or the paper tape reader. This is possible when the system is 
in the Monitor's Command Batching Mode. Batching Mode allows many 
programs to be run in sequence with minimum operator intervention. 

A typical sequence of operations might include file editing, assembly 
and program execution. All commands input from the batch device are 
echoed on the console teleprinter. 

8.12.1 Preparation 

For Command Batching Mode, the programmer must prepare a paper tape 
or a deck of punched cards which contains the keyboard commands for 
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the operations to be performed. These commands should be in 
the same order and form as they would normally be issued from the 
teleprinter keyboard. The only exception to this is that certain job 
control commands must be inserted in the command sequence. When pre- 
paring paper tapes, the user will find it convenient to use the system's 
Text Editor Program EDIT. When preparing commands for input from cards, 
the user can prepare his cards using a card punch which punches either 
02J or 026 Hollerith codes (see Appendix F) . 

8.12.2 Operator Commands 

The following commands are provided for operator control: 

" 12.2.1 BATCH - This command is used to enter Command Batching Mode. 
Once this command is issued, the Monitor begins to read from the batch 
device specified (PR = paper tape reader, CD = card reader). 

Form: B[ATCH] ^ 

8.12.2.2 CTRL T - This command causes the Monitor to skip to the next 
job (i.e., skip to the next $ffOB job separator. See 8.12.3.1). 

8.12.2.3 CTRL C - This command is used to terminate Command Batching 
Mode operation. It operates in allj other respects as it does with 
normal keyboard operation (see 8.1lj.l). 

8.12.2.4 CTRL R - This command is used to recover from either the 
execution of a $PAUSE (see 8.12.3.4) or an IOPS4 (see 8.11.5). 

8.12.3 Job Control Commands 

The following commands are inserted into the normal keyboard' command 
sequences on the batch device medium to provide job control. 

8.12.3.1 $ JOB - This command separates one job from the next. (The 
loading of any system or user program constitutes a job.) The command 
operates, within the context of Command Batching Mode, in a manner sim- 
ilar to the CTRL C command since it causes the Batching Mode Nonresident 
Monitor to be reloaded, and all .DAT/.UFDT slot assignments to be reset 
to their default settings, if KEEP is OFF. §JOB must occur as the first 
command on the batch medium and can be used thereafter each time the 
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user wishes to exit from tie current program and issue another command 
to the Monitor. 

Form: $JOB UJ comment ^ 

where: comment = User comments 

8.12.3.2 $DATA - When the batch device is to be used for data input 
Cas it might be in non-batch mode) , this command marks the beginning 
of the data. Unlike BATCH commands, data is not printed on the tele- 
printer . 

Form: $DATA. .comment s 

where: comment = User comments 

8.12.3.3 $END - This command follows the $DATA command and data to 
signify the end of the data. 

Form: $END | ^comment 

where: comment = User comments 

8.12.3.4 $ PAUSE - This command terminates input from the batch device 
until the operator types a CTRL R. It has particular application when 
the user wishes to signal the operator to mount a DECtape, reload the 
batch device, or perform some other manual operation. 

Form: $PAUSE l _ J comment j 

where: comment = User comments 

8.12.3.5 $EXIT - This command signals the Monitor to leave Command 
Batching Mode and resume operation using commands from the teleprinter 
keyboard. 

Form: $EXIT. .comment j 

where: comment - User comments 

8.12.4 Restrictions 

When operating in Command Batching Mode, the following restrictions 
apply: 
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a. The following commands are illegal: QDUMP , HALT, 

GET (all forms), PUT, BATCH, BOSS 15, LOAD, DDT, DDTNS . 

b. Any ASSIGN command which references either batch de- 
vice will automatically obtain the services of the 
current batch device handler. This is because the 
card and paper tape devices are mutually exclusive 
when in Batching Mode. Thus, if the card reader is 
the batch device, an ASSIGN PR -4 will result in the 
card reader assigned to .DAT -4. Functions provided 
by these handlers are equivalent to those provided 

in the PRA or CDB handlers as described in Chapter 9. 

c. When using the REQUEST command, .DAT slots assigned 
to the batch device are printed as either PR* (paper 
tape reader) or CD* (card reader) . 


8.13 KEYBOARD ERROR DETECTION AND HANDLING 


The Monitor performs comprehensive error checking on all keyboard com- 
mands typed. Upon detection of an error, an appropriate message is 
output to the teleprinter indicating the nature of the error, and the 
remainder of the line from the error is ignored. The dollar sign ($) 
prompting symbol is then output to indicate the Monitor's readiness 
to accept another command. Keyboard errors which result during opera- 
tion of system programs are explained in the appropriate reference 
manual for the particular program (see Preface) . Error messages which 
are prefixed by "IOPS" , " .SYSLD" or ".LOAD" are listed and explained in 
Appendices D and E. respectively. 



CHAPTER 9 


I/O DEVICE HANDLERS 


9.1 INTRODUCTION 

This chapter describes the I/O device handling routines which are sup- 
plied as a part of the DOS-15 system software. Included in this chap- 
ter are their operating characteristics and their applicability for 
use with the various language and utility programs in the DOS-15 system. 

Each I/O device handler has a unique three-character name which is used 
when assigning it to a .DAT slot via the ASSIGN keyboard command (see 
8.5.2). The first two characters of the name designate the device with 
which the handler operates. For example: DK = DECdisk; DP = Disk Pack; 
TT = Teleprinter, etc. The third character specifies a particular ver- 
sion of a handler, since some I/O devices have several handlers. Thus, 
DKA designates the "A" version of the DECdisk device handler. Similarly, 
DTC is the "C" version of the DECtape handler. Table 9-1 lists the 
standard DOS-15 I/O device handlers. 


Table 9-1 

DOS-15 I/O DEVICE HANDLERS 1 


Device Name 

Version ! 

A 

B 

C 

D 

E 

F 

DK 

(DECdisk 

/ 

/ 

/ 




DP 

(Disk Pack) 

/ 

/ 

/ 




DT 

(DECtape ) 

/ 


/ 

/ 

/ 

/ 

TT 

(Teleprinter) 

/ 






PR 

(Paper Tape Reader) 

/ 

/ 





PP 

(Paper Tape Punch) 

/ 

/ 

/ 




LP 

(Line Printer) 

/ 






CD 

(Card Reader) 


/ 





VP 

(VP15A Display) 

/ 






MT 

(Magtape) 

/ 


/ 



/ 


1 Users having a VT15 Graphic Display System should refer to the 
GRAPHIC15 Programming Manual (DEC-15-ZFSA-D) for descriptions of the 
associated device handlers VTA, LKA , and VWA. 
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The availability of several handler versions allows the user who is 
concerned with core utilization to select a particular version with the 
size and capabilities most nearly suited to his needs. Device handler 
versions differ from one another in the number of I/O functions (Macros) 
and Data Modes allowed, and in the number of files which can be accessed 
concurrently. The fewer capabilities allowed, the smaller the handler. 
"A" version handlers are the largest, but also provide the greatest 
capabilities. Other versions are more limited, and consequently are 
smaller. 


In selecting a handler, the user must consider all I/O requirements 
for the program with which it is to run. What I/O Macros and Data Modes 
are used? Is output required? How many files may be concurrently open? 
To assist the user in selecting handlers, paragraph 9.2 lists all 
versions of the handlers which can be assigned to the various .DAT 
slots used by the various DOS-15 System programs, and paragraph 9.3 
describes the specific functional characteristics of the handlers. 


9.2 DEVICE HANDLERS ACCEPTABLE TO SYSTEM PROGRAMS 


The following paragraphs provide listings of .DAT Slot assignments 
for the various system programs and the I/O device handlers which 
may be assigned to each. Standard assignments for the system 
initially supplied are indicated by an asterisk (*) . 
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NOTE: Only one I/O handler for a particular device may be in core 

at the same time, since there is no communication between the interrupt 
handling routines. 


9.2.1 FORTRAN IV (F4) 


.DAT Slot 

Use 

Handler 

-13 

Output 

PPA 

PPB 

PPC 

*DKA , *DPA , DTA , MTA 

DKB, DPB , 

DTD, 

DTE 

DTF , MTF 

-12 

Listing 

*TTA 

LPA 

VPA 

PPA 

DKA , DPA , DTA, MTA 

DKB, DPB, 

DTD 

i DTE 

i DTF , MTF 

-11 

Input 

TTA 

PRA 

PRB 

*DKA, *DPA , DTA, MTA 

DKB, DPB, 

DKC , DPC , DTC , MTC 

DTD, 

DTE , 

DTF , MTF 
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9.2.2 MACRO-15 


.DAT Slot 

Use 

Handler 

-14 

Macro 

Definitions 

File 

TTA 

PRA 

PRB 

CDB 

*DKA , *DPA , DTA , MTA 

DKB , DPB , DTD 

DKC, DPC , DTE 

-13 

Output 

PPA 

PPB 

*DKA, *DPA 

DKB, DPB 

-12 

Listing 

Output 

*TTA 

LPA 

VPA 

PPA, DPA, DTA, MTA 

DKB, DPB, DTD 

DTE 

-11 

Input 

TTA 

PRA 

PRB 

CDB 

*DKA, *DPA , DTA, MTA 

DKB, DPB, DTD 

DKC , DPC , DTE 

-10 

Parameter 

File 

Input 

*TTA 

PRA 

PRB 

CDB 

DKA , DPA, DTA, MTA 

DKB, DPB, DTD 

DKC, DPC, DTE 
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9.2.3 FOCAL 


.DAT Slot 

Use 

Handler 

3 

Library 

Input 

TTA 

PRA 

PRB 

CDB 

*DKA , *DPA , DTA , MTA 

DKB, DPB , DTC , MTC 

DKC , DPC , DTD , 

DTE 

5 1 

Library 

Output 

TTA 

PPA 

DKA , DPA, DTA, MTA 

DKB, DPB, DTD 

LPA, DTE 

VPA 

7 

. 

Data File 
Input 

TTA 

PRA 

PRB 

CDB 

DKA, DPA, *DTA , MTA 

DKB, DPB, DTC, MTC 

DKC, DPC, DTD 

DKE , DTE 

10 

Data File 
Output 

TTA 

PPA 

DKA, DPA, *DTA , MTA 

DKB, DPB, DTD 

LPA DTE 

VPA 


1 Prior to loading FOCAL, this .DAT slot must be reassigned to one 
of the devices listed, if library output is desired. 
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9.2.4 EDIT, EDITVP, and EDITVT 


.DAT Slot 

Use 

Handler i 

-15 

Scratch/ 

Output 

TTA 

VPA j 

LPA 

PPA 

*DKA, *DPA , DTA/ MTA 

DKB , DPB , DTD 

DTE 

-14 

Input 

TTA 

PRA 

PRB 

CDB 

*DKA, *DPA , DTA, MTA 

DKB, DPB, DTD 

DKC , DPC , DTE 

-10 

Secondary 

Input 

*TTA 

PRA 

PRB 

CDB 

DKA, DPA , DTA, MTA 

DKB, DPB, DTD 

DKC, DPC, DTE 

10 

Display 

Output 

(EDITVP only) 

VPA 


9.2.5 Linking Loader and DDT 


.DAT Slot 

Use 

Handler 

-5 

External 

User 

Library 

Input 

*NON 

-4 

User 

Program 

Input 

PRA 

*DKA, *DPA, DTA 

DKB, DPB, 

DKC, DPC, DTC 

DTD 

DTE 

-1 

System 

Library 

Input 

PRA 

*DKA, *DPA, DTA 

DKB, DPB, 

DKC, DPC, DTC 

DTD 

DTE 


9-6 























9.2.6 PIP (Peripheral Interchange Program) 


PIP uses all positive .DAT slots and -2 and -3 for TTY I/O. Prior to 
use, any non-standard device assignments should be made via the ASSIGN 
command to the Monitor. If several functions are to be used with a 
variety of peripherals, assignment of these devices all at the same 
time avoids the necessity for returning to the Monitor to reassign 
devices and for repeatedly reloading PIP after each operation that 
requires a new device. 


NOTE 

The device handlers used with PIP should normally 
be those having the greatest capability (i.e., PRA, 
PPA, DTA, DKA, etc.). If both input and output are 
to occur on the same device (e.g., DECtape) , separate 
.DAT Slots must be assigned. Both .DAT Slots must 
be assigned to the same handler. 


Positive .DAT Slot assignments for the system, as initially supplied, 
are as follows: 


.DAT Slot 

Use 

Hand ler 

1 

I/O 

*DKA or *DPA 

2 

I/O 

*DKA or *DPA 

3 

I/O 

*DKA or *DPA 

4 

I/O 

*TTA 

5 

Input 

*PRA 

6 

Output 

‘PPA 

7 

I/O 

*DTA 

W 

I/O 

*DTA 

11 

I/O 

*NON 

12 

I/O 

*NON 

13 

I/O 

‘NON 

14 

I/O 

‘NON 

15 

I/O 

‘NON 

16 

I/O 

‘NON 

17 

I/O 

‘NON 

20 

I/O 

‘NON 


9.2.7 SGEN (System Generator) 


.DAT Slot 

Use 

Handler 

-14 

Input/Output 

*DKA or *DPA 
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9.2.8 PATCH 


.DAT Slot 

Use 

Handler 

-14 

I/O 

*DKA, *DPA, DTA 

DTD 

DTE 

-10 

Secondary 

Input 

*TTA 

PRA 

DKA , DPA , DTA 


9.2.9 UPDATE 


.DAT Slot 

Use 

Handler 

-15 

Output 

PPA 

PPB 

PPC 

DKA, DPA, DTA, MTA 

DKB, DPB 

-14 

Input 

PRA 

*DKA, *DPA , DTA, MTA 

DKB, DPB 

DKC , DPC 

-12 

i 

Listing 

LPA 

*TTA 

VPA 

PPA 

- DKA, DPA, DTA, MTA 

DKB, DPB 

-10 

Secondary 

Input 

*TTA 

PRA 

DKA, DPA, DTA, MTA 

DKB, DPB 

DKC , DPC 


9.2.10 DUMP 


.DAT Slot 

Use 

Handler 

-14 

Input 

*DKA , *DPA , *DTA , MTA 

DKB, DPB, DTD 

DKC, DPC, DTE 

-12 

Listing 

*TTA 

LPA 

VPA 

PPA 

DKA, DPA, DTA, MTA 

DKB, DPB, DTD 

DTE 
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9.2.11 CHAIN 


.DAT Slot 

Use 

Handler 

-5 


*NON (same as .DAT slot -4 when used) 

-4 

Input 

PRA 

*DKA, DP A, DTA, MTA f Use only 

DKB, DPB 1 if no other 

DKC, DPC f DTC , MTC ( DT , DK, or 

DTD I MT is as- 

DTE l^signed. 

-1 

System 

Library 

Same as for .DAT -4 


NOTE 


Use the smallest handlers possible since they are not 
recoverable as user handlers in the overlay system. 


9.2.12 EXECUTE 


.DAT Slot 

Use 

Handler 

-4 

CHAIN-Built 
Overlay Sys- 
tem Input 
(i.e., XCI* 
XCU Files) 

PRA 

*DKA, *DPA, DTA, MTA . 

oke! dpb (III f 

DKC, .. DPC,. DTC, MTC< £°^ h S ^ aret ? 

' ' ) with overlay 

Vsystem 

DTE v 


9.2.13 SRCCOM (Source Compare) 


•DAT Slot 

Use 


Handler 










-15 

Old File 

TTA 

(if not 

assigned to 

-14) 



Input 

PRA 

(if not 

assigned to 

-14) 




CDB 

(if not 

assigned to 

-14) 




*DKA, 

*DPA , 

DTA, MTA 





DKB, 

DPB, 

DTD 





DKC, 

DPC, 

DTE 



-14 

New File 

TTA 

(if not 

assigned to 

-15) 



Input 

PRA 

(if not 

assigned to 

-15) 




CDB 

(if not 

assigned to 

-15) 




*DKA, 

*DPA , 

DTA , MTA 





DKB, 

DPB, 

DTD 







DTE 



-12 

Listing 

*TTA 







PPA 

LPA 

VPA 

DKA, 

DPA, 

DTA, MTA 





DKB, 

DPB, 

DTD, 

DTE 
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9.2.14 DTCOPY (DECtape Copy) 


•DAT Slot 

Use 

Handler 1 

-15 

Output 

DTA 

DTD 

DTE 

-14 

Input 

DTA 

DTD 

DTE 


9.2.15 8 TRAN tPDP-8 to PDP-15 Translator) 

89TRAN (PDP-8 to PDP-9 Translator) 


.DAT Slot 

Use 


Handler 








-15 

Input 

PRA 
CDB 
TTA 
*DKA , 

*DPA, 

DTA, 

MTA 



DKB , 

DPB , 

DTD 




DKC , 

DPC , 

DTE 


-14 

Output 

PPA 

LPA 

TTA 

VPA 

DKA, 

DP A, 

DTA, 

MTA 



DKB, 

DPB, 

DTD 






DTE 



9.2.16 MTDUMP (Magtape User's Utility Program) 



Use 

Handler 

■ 

Input 

Output 

MTA , MTF 

MTA, MTF, TTA 


9.3 I/O HANDLER DESCRIPTIONS 


The following paragraphs describe the operating features of the standard 
DOS-15 I/O Device Handlers. The DOS-15 System Manual (DEC-15-NRDA-D) 
describes functions which are internal to the handlers and provides 
instructions to assist users in creating their own special device hand- 
lers. Users having a VT15 Graphics Display System should refer to 
the GRAPHIC15 Programming Manual (DEC- 15- ZFSA-D) for descriptions of 
the associated device handlers VTA, LKA, and VWA. 


J Prior to program loading, one of these handlers must be assigned to 
both .DAT slots. 

*Prior to loading this program, the .DAT slots must be reassigned to 
one of the handlers listed here. 
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9.3.1 Teleprinter Handler (TTA) 


9.3.1. 1 General Description - The teleprinter handler is embedded in > 
the Resident Monitor and provides all functions necessary for tele- 
printer input/ output. The handler performs 1/ 0 using either IOPS ASCII 
(Mode 2) or Image Alphanumeric (Mode 3) data. Table 9-2 lists the 
handler's responses to the various I/O Macros. 

Table 9-2 


TELEPRINTER I/O FUNCTIONS 


Macro 

Response 

.INIT 

Accept 

. FSTAT 

Ignore 

.RENAM 

Ignore 

. DLETE 

Ignore 

• RAND 

Illegal 

. RTRAN 

Illegal 

• SEEK 

Ignore 

. ENTER 

Ignore 

•CLEAR 

Ignore 

.CLOSE 

Accept 

. MTAPE 

Ignore 

• READ 

Accept 

.WRITE 

Accept 

.WAIT 

Accept 

. WAITR 

Accept 

.TRAN 

Illegal 


Illegal = Illegal Function (I0PS6) 

9. 3. 1.2 Device Dependent Characteristics - The following paragraphs 
describe the characteristics which are unique to the teleprinter 
handler in its response to certain I/O Macros and characters: 

a. .INIT 1) Maximum I/O buffer size returned: 42g(34 1Q ) 

2) Set up CTRL P restart address from address 
specified in .INIT argument "restrt". Refer 
to the DOS-15 System Manual (DEC-15-NRDA-D) 
for setup of the restart addresses for CTRL C • 
and CTRL T. 

3) Output Carriage RETURN/LINE FEED 
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b. .CLOSE - Output Carriage RETURN/LINE FEED. 

c. .WRITE - When in IOPS ASCII Mode a LINE FEED is normally 

output automatically before the line (logical 
record) is output unless an Overprint (20) is 
the first character (see Table 9-3) . 

d. Nonprinting Function Characters - The non -printing 

function characters contained in Table 9-3 
have special significance when input and out- 
put in IOPS ASCII mode. 


Table 9-3 

SPECIAL NON-PRINTING FUNCTION CHARACTERS FOR IOPS ASCII TELEPRINTER I/O 


FUNCTION 

(ASCII in parentheses! 

TRANSFER 

DIRECTION 

ACTION 

Carriage RETURN 
( 015 ) 

Input 

Insert all characters typed, includ- 
ing this Carriage RETURN, since the 
last Carriage RETURN or ALT MODE, 
into the requesting program's I/O 
Buffer. Echo a LINE FEED on the 
printer. 


Output 

Terminate output of the contents 
of the requesting program's I/O 
buffer. Output Carriage RETURN. 

ALT MODE 
(33, 175, 176) 

Input 

Terminate the current line and in- 
sert all characters typed since the 
last Carriage RETURN or ALT MODE into 
the requesting program's I/O buffer. 
Map into the I/O Buffer as 175. 


Output 

Terminate output of the contents of 
the requesting program's I/O buffer. 

LINE FEED 
(0 12) 

Input 

Insert in requesting program's I/O 
buffer. 


Output 

Ignore if this is the first charac- 
ter in the I/O buffer; otherwise, 
output. 

VT (Vertical Tab) 

(013) 

Input 

Insert in requesting program's I/O 
buffer. 

or 



FORM Feed 
(014) 

Output 

Model 35 teleprinters output FORM 

Feed . 

Model 33 teleprinters ignore. 
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Table 9-3 (Cont.) 


FUNCTION 

(ASCII in parentheses) 

TRANSFER 

DIRECTION 

ACTION 

Horizontal TAB 

0311) 

Input 

Insert in requesting program's I/O 
buffer . 


Output 

Model 35 teleprinters output TAB 
(011) • 

Model 33 teleprinters output suffi- 
cient number of SPACES (040) to 
position printer at columns 9, 17, 

25, . . . etc. 

Skip One Line 

0021) 

Output 

Only 

. . 

If this is the first character in the 
requesting program's I/O buffer, skip 

1 line. Otherwise, ignore. 

Overprint 

002/3) 

Output 

Only 

If this is the first character in the 
requesting program's I/O buffer, 
suppress the LINE FEED normally out- 
put. Otherwise, ignore. 

RUBOUT 

(177) 

Input 

Delete the last character typed 
previous to this and echo a backslash 
( \ )• 

CTRL U 

(025) 

Input 

Delete all characters typed since 
the last Carriage RETURN or ALT 

MODE, and echo an "at" sign ( @ ). 


Output 

If typed while output is under way, 
truncate the remainder of the logical 
record being input and output an "at" 
sign ( @ ) plus Carriage RETURN. 

Null 

000/3) 

Input/ 

Output 

Ignore 

CTRL D 

(00/1) 

Input 

Transmit to the requesting program's 
I/O buffer a logical record which 
consists of a header word pair only, 
with the I/O Mode Bits (14-17) set 
to 0101 to indicate end-of-file. 

(See paragraph 6.3.1. 1.) 


9. 3. 1.3 Program Control Characters - The teleprinter retains its role 
as control device during all I/O operations. The CTRL characters 
(CTRL c, CTRL P, CTRL S, and CTRL T) are recognized when typed, regard- 
less of Data Mode or transfer direction. These characters perform 
specific system functions as described in 8.1 . Experienced users who 
wish to alter their meaning may do so using procedures described in 
the DOS-15 System Manual H3EC-15-NRDA-D) . 
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9.3.2 Paper Tape Punch Handlers (PPA, PPB, and PPC) 


9.3. 2.1 General Description - There are three paper tape punch 
handlers: PPA (571g registers), PPB ( 4 1 6 g registers), and PPC (3 2 2 Q 

registers). All three handlers respond identically to the I/O 
Macros, but differ as to the various data modes which are acceptable 
to them. Table 9-4 lists the data modes which are acceptable and 
Table 9-5 shows the handlers' responses to the I/O Macros. 

Table 9-4 


PAPER TAPE PUNCH DATA MODES 


Data Mode 

H 

andler 

PPA 

PPB 

PPC 

IOPS ASCII 

X 

- 

- 

IOPS Binary 

X 

X 

X 

Image 

Alphanumeric 

X 

X 

- 

Image Binary 

X 

X 

- 

Dump 

X 

X 

- 


Table 9-5 


PAPER TAPE PUNCH I/O FUNCTIONS 


Macro 

Response 

. INIT 

Accept 

. F ST AT 

Ignore 

•RENAM 

Ignore 

•DLETE 

Ignore 

-RAND 

Illegal 

. RTRAN 

Illegal 

.SEEK 

Illegal 

. ENTER 

Ignore 

. CLEAR 

Ignore 

.CLOSE 

Accept 

. MTAPE 

Ignore 

.READ 

11 legal 

.WRITE 

Accept 

.WAIT 

Accept 

. WAITR 

Accept 

.TRAN 

Illegal 


Illegal = Illegal Function (I0PS6 Error) 
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9. 3. 2. 2 Device Dependent Characteristics - The following paragraphs 
describe the characteristics which are unique to the Paper Tape Punch 
Handlers in their response to certain I/O Macros and characters. 


a. 


b. 


.IN IT - 


. CLOSE - 


1) 

Maximum 

I/O 

buffer size 

returned 

: 64 g (52 

2) 

Punches 

two 

fanfolds of 

leader . 


1) 

Output 
(see 6. 

EOF 

3.1. 

(end-of-file) header 
1) as last record on 

word pair 
the tape . 

2) 

Punches 

two 

fanfolds of 

leader. 



c. Special Characters - The characters listed in Table 9-6 
have special significance to the handlers 
when output in IOPS ASCII Mode. These char- 
acters, except TAB, are ignored if they do 
not appear as the first character in a logi- 
cal record (line). If a LINE FEED, VT (Verti- 
cal Tab) , or FORM Feed does not appear as the 
first character in a logical record, a LINE 
FEED is supplied by the handlers. 


Table 9-6 

SPECIAL FUNCTION CHARACTERS FOR FIRST CHARACTER IN LINE 


FUNCTION 

ACTION 1 

LINE FEED 

Output. 

(012) 


VT (Vertical TAB) 

Output, followed by four RUBOUTs 1 (177). 

(013) 


FORM Feed 

Output, followed by 40 Nulls* (000). 

(014) 


Horizontal TAB 

Output, followed by one RUBOUT* (177). 

(011) 



9.3.3 Paper Tape Reader Handlers (PRA and PRB) 

There are two paper tape handlers: PRA (673„ registers) and PRB (446 0 

o O 

registers). Both handlers respond identically to the I/O Macros, but 
differ as to the data modes which are acceptable. Table 9-7 lists the 
data modes which are acceptable, and Table 9-8 shows the handlers' re- 
sponse to the I/O Macros. 


*The RUBOUT and NULL functions which follow output of the desired char- 
acters are used for hardware timing purposes when the paper tape is 
to be transmitted to a printer in an off-line environment. 
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Table 9-7 


PAPER TAPE READER DATA MODES 


Data Mode 

Handler 

PRA 

PRB 

IOPS Ascii 

X 

X 

IOPS Binary 

X 

- 

Image 

Alphanumeric 

X 

- 

Image Binary 

X 

- 

Dump 

X 

- 


Table 9-8 


PAPER TAPE READER I/O FUNCTION 


Macro 

Response 

. INIT 

Accept 1 

•FSTAT 

Ignore 

.RENAM 

Ignore 

. DLETE 

Ignore 

-RAND 

Illegal 

. RTRAN 

Illegal 

.SEEK 

Ignore 

•ENTER 

Illegal 

•CLEAR 

Illegal 

•CLOSE 

Accept 

. MTAPE 

Ignore 

• READ 

Accept 

•WRITE 

Illegal 

• WAIT 

Accept 

• WAITR 

Accept 

• TRAN 

Illegal 


Illegal = Illegal Function (IOPS6 Error) 


Maximum I/O buffer size returned: 64g (52 1Q ) . 
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9.3.4 DECtape Handlers (DTA, DTC, DTD, DTE, and DTF) 

9.3. 4.1 General Description - There are five DECtape handlers for 
TU55/TU56 DECtape operation: 

o DTA (2761g locations) is the most general DECtape 
handler provided. It has a simultaneous three- 
file capacity, either input or output. Input files 
can be referenced on the same or different DECtape 
units; however, not more than one output file can 
exist on the same unit. (I.e., file creation on 
the same unit must occur sequentially.) 

o DTC (1261g locations) is the most limited and also 
the most conservative of core (for IOPS data mode 
operations) of the handlers. It is an input only 
handler with a one-file capacity. 

o DTD (3 071 8 locations) provides single file operation, 
either input or output. 

o DTE (2674g locations) is similar to DTD, differing 
only in its I/O function capabilities as shown in 
Table 9-10. 

o DTF (1151g locations) is a handler which simulates 

the non-director ied , sequential access file structure 
of Magtape. It accommodates (serially) up to eight 
DECtape units, both input and output. When the last 
block of a tape on a particular unit has been accessed, 
DTF causes the Monitor to output an IOPS4 message 
(Device Not Ready) to permit the operator to remove 
the current tape from the DECtape drive and mount 
another. The operator can then type a CTRL R to con- 
tinue processing. 


Table 9-9 illustrates the data modes which are acceptable to these 
handlers, while Table 9-10 shows the handlers' responses to the vari- 
ous I/O Macros. 


Table 9-9 

DECTAPE DATA MODES 


Data Mode 

Handler 

DTA 

DTC 

- 

DTD 

DTE 

DTF 

IOPS ASCII 

X 

X 

X 

X . 

- 1 ' ' " 

X 

IOPS Binary 

X 

X 

X 

X 

X 

Image 

Alphanumeric 

X 

- 

X 

_. x 

- 

Image Binary 

X 

- 

X 

X 

- 

Dump 

X 

“ 

X 

X 

— 
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9. 3. 4. 2 Device Dependent Characteristics - The following character- 
istics are unique to the DECtape Handlers in their responses to certain 
I/O Macros. 

a. . INIT - Maximum I/O buffer size returned: 377 g ( 2 5 5 ^ Q ) . 

b. . MTAPE 1) DTD accepts REWIND and BACKSPACE RECORD 

subfunctions only. 

2) DTF accepts REWIND, BACKSPACE RECORD and 
SKIP RECORD subfunctions only. 

Table 9-10 


DECTAPE I/O FUNCTIONS 



9.3.5 DECdisk and Disk Pack Handlers (DKA/DPA , DKB/DPB , and DKC/DPC) 

9. 3. 5.1 General Description - Three handlers are provided for RV-15 
DECdisk and RP-02 Disk Pack operations. Version for version, these 
handlers are identical in their functions with these two exceptions: 

a. While both the DECdisk and Disk Pack are block address- 
able for direct access operations (.TRAN and .RTRAN 
Macros) the DECdisk in addition provides word address- 
ability. 
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b. The Disk Pack has a unit structure while the DECdisk 
does not. This means that each DECdisk is treated as 
a single addressable unit regardless of the actual 
number of platters incorporated (up to 8) . 


All versions of these handlers support the disk file structures de- 
scribed in Chapter 3. There is no fixed limit as to the number of input 
or output files which can be simultaneously accessed, except as deter- 
mined by the amount of available buffers. To this end, the handlers 
perform dynamic buffer allocation from the Monitor’s buffer pool, using 
the . GTBUF and .GVBUF Monitor Macros described in Chapter 5. At run 
time, the operator need only be concerned that the number of files con- 
currently accessed is not greater than the number of buffers allocated 
by the BUFFS Keyboard command (see 8.6.1). 

The following commands obtain buffers from the pool, and return them 
immediately upon completion of the operation: 

. DLETE 
.RENAM 
.CLEAR 


The following commands obtain a buffer from the pool and do not return 
it until a subsequent .CLOSE, .INIT or Rewind ( .MTAPE) is performed: 

. FSTAT 
.ENTER 
.SEEK 
-RAND 


The following commands return a buffer to the pool, if any was taken: 

.INIT 

.CLOSE 

.MTAPE (.Rewind subfunction) 

The handlers operate in all data modes (i.e., IOPS, Image, and Dump). 
Table 9-11 lists the I/O Macros which are acceptable to the various 
handler versions. 
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Table 9-11 


DECDISK AND DISK PACK I/O FUNCTIONS 


Macro 

Handler i 

DKA(4274p ) 

DPA (4561g ) 

DKB (3631 fl ) 

DPB (4007g ) 

DKC (2163 ) 
DPC (2275), ) 

O 

.INIT 

. FSTAT 

. DLETE 

.RENAM 

.RAND 

. RTRAN 

.SEEK 

. ENTER 

. CLEAR 

.CLOSE 

. MTAPE 

.READ 

.WRITE 

• WAIT 

. WAITR 

.TRAN 

i 

Acc 

\ 

\ 

ept 

Accept 

Accept 

Illegal 

Accept 

Accept 

Illegal 

Accept 

Illegal 

Accept 

1 

Illegal 

Accept 

Accept 

A 

Illegal 

Accept 

Illegal 

Illegal 

Accept 

Illegal 

Accept 

Illegal 

Accept 

Accept 

Illegal 


9. 3. 5. 2 Device Dependent Characteristics - The following character- 
istics are unique to these handlers in responding to certain I/O Macros: 

a. . INIT 

1) Maximum I/O buffer size returned: 376g (254^). 

2) The disk handlers allow write verification on output files. 
If the file is defined as an output file, the user has the 
opportunity of guaranteeing the integrity of his data by 
using llg as the "dd" argument to the .INIT macro. The 
handler will then check every block of data it writes 
out, to ensure that the transfer occurred without error. 

A second .INIT command must be executed to remove or add 
the write checking feature. 

31 An output file already opened on a .DAT slot referenced by 
•INIT will be deleted. If a .INIT references a .DAT slot 
with an opened input file, the handlers will close it, 
and give back the buffer it was using. 

4) Control is retained until all necessary I/O is complete. 

5) The .INIT macro uses the relationship between the User 
File Directory Table and the Device Assignment Table to 
get the correct UIC from the User File Directory Table. 

If the user is changing UIC's under program control (via 
.USER macros) , the operation must be accomplished before 
a .INIT in order to obtain the desired UFD . 
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b . . DLETE 

1) Control is not returned until all necessary Disk I/O is 
complete. If the UIC associated with this .DAT slot 
does not exist in the MFD, or if the named file can not 
be found, the disk handlers ignore this macro. If the 
name is found, the handlers return the first block num- 
ber of the file in tlie AC. The buffer used by the hand- 
lers to delete the named file is given back to the buf- 
fer pool upon completion of the .DLETE. 

2) The .DLETE macro follows the protection rules for di- 
rectory modification. That is, .DLETE will not work on 
a protected directory, but returns an IOPS 63 error. 


c . . RENAM 

1) The first block number of the renamed file is returned 
in the AC after a successful operation. If the file or 
UFD does not exist, the handlers return to LOC+3 with 

0 in the AC. .RENAM changes the renamed file's date to 
the current date (maintained by the DATE keyboard command 
described in Chapter 8) . 

2) At completion of the .RENAM function, the handlers re- 
turn the buffer to the buffer pool. 

3) The .RENAM macros must follow the protection rules for 
directory modification. That is, .RENAM will not work 
on a protected directory (IOPS 63) . 

d . . ENTER 

1) The handlers check for directory protection. If any of 
the following conditions is satisfied, the handlers will 
allow successful operation. If none is satisfied, the 
handlers will terminate with an IOPS 63. 

Conditions for gaining UFD access: 

Entry in .UFDT equals the logged-in UIC 

Logged- in UIC equals MIC 

Directory protection code equals 0 

2) Once the entry in the UFD has been made via the .ENTER, 
the file is defined as being opened and truncated. Upon 
a subsequent .CLOSE, the file will exist as a closed 
file, but not truncated. 

3) When a .ENTER is done with a file name that already 
exists, the old file is deleted only after the new 
file (just .ENTERed) is .CLOSEd, if the old file is not 
truncated. If the old file is a truncated file, it is 
deleted immediately, before the new file is listed in 
the UFD. The process of deletion of identically named 
truncated files continues until a non- truncated file 
with the same name is found. At this point, the new 
directory entry is made. Truncated files which follow 
are not deleted. In all cases, UFD searches are 
sequential starting at the beginning. 
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e. .CLEAR 

1) The disk handlers will not honor .CLEAR unless the user 
has logged in under the MIC. The .CLEAR function deletes 
all files and directories on the entire disk. All bit maps 
are closed and indicate only the space which they occupy. 
The MFD will have no UFD's, SYSBLK or BAT. An I/O buffer 
is obtained from the pool for this operation and is subse- 
quently returned on its completion. 

f. .CLOSE 

1) On input, the handlers give the buffer back (if 

one was acquired) and make the .DAT slot available 
for subsequent . INITs . On output, the handlers 
write an end-of-file record (if the user did not 
already write one) , and then proceed as on input. 


g. .READ 

1) All .READ commands executed after an end-of-file 
(EOF) header has been reached will return an EOF 
in header word 0 (001005) . 

h. . MTAPE 

1) DKA and DPA accept the REWIND and BACKSPACE sub- 
functions during input only. REWIND is effectively 
a .CLOSE. 

i . . TRAN 

1) The .TRAN is not included as part of the disk file 
structure. That is, all blocks read or written are 
done so at the user's discretion. MFD ’ s , UFD's, 

Bit Maps, and RIB's are not considered, and are not 
protected from the .TRAN macro. The .TRAN macro is 
allowed to any .DAT slot that has been .INITed, and 
not .CLOSEd or rewound (via a .MTAPE) . 

2) For the RF DECdisk, the user can reference a specific 
platter just by identifying the block number he 
wants. The block numbers and platter relationships 
are shown below: 

Platter Number Block Number 

0 0-1777 

1 2000-3777 

2 4000-5777 

3 6000-7777 

4 10000-11777 

5 12000-13777 

6 14000-15777 

7 16000-17777 

j. . FSTAT 

1) Normal operations, except that a subsequent .SEEK 

to a file found via .FSTAT will not require redundant 
disk access. That is, both .FSTAT and .SEEK ordinarily 
require a minimum of three disk accesses — one to the 
MFD, one t o the UFD, and one to the file. If the user 
does a .FSTAT to an existing file, and then a -SEEK, 
the disk handlers "remember" the successful .FSTAT, 
and do not do an extra disk access. 
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k. .RAND 

15 .RAND commands to a nonexistent file cause an I0PS13. 
Those to a nonexistent UFD cause an I0PS51. Those to 
an empty UFD cause an X0PS71. 

l . . RTRAN 

11 The disk pack handler ignores the word number argument 
(assumed to be J3) and returns the whole block. If the 
word number plus the word count exceeds 254. Q , the 
disk handlers will return IOPS67. 

Output .RTRAN to the Rp disk requires 256- L Q-word buf- 
fers to allow the handlers to supply the correct 
links in the last two words. (Otherwise, random 
files would require two buffers from the pool.) 

If the block number argument requested by the .RTRAN 
is less than one, or greater than the number of blocks 
in the file, an IOPS66 will result. 

9.3.6 Magtape Handlers (MTA, MTC, and MTF) 


9. 3. 6.1 General Description - Three handlers are provided for operation 
of Magtape drives TU10, TU20A, TU20B, TU30A, and TU30B. These handlers 
permit control of up to eight transports. 


o MTA (4600 locations) is* the most general and permits 
either industry-standard flagtape file structuring, 
using the .MTAPE Macro, or DECtape file structuring 
using .SEEK and .ENTER Macros (refer to Chapter 4). 
When treated as DECtape, up to three files can be 
concurrently referenced, each on a different trans- 
port, either input or output. 


o MTC (1253 a locations) is a read-only handler designed 
for operation using DECtape file structuring only. 

It has a single file capacity; sequential file refer- 
ences are, of course, allowed. 

o MTF (1307g locations) is designed for Magtape file 
structuring only. It accommodates up to eight con- 
currently referenced transports, both input and output. 


The track count (either 7- or 9-channel) can be set at System Genera- 
tion, or by using the CHANNEL Keyboard Command. In addition, it can 
also be set dynamically, along with parity and recording density param- 
eters, using the .MTAPE I/O Macro (see paragraph 6.7.7) when using 
Magtape file structuring. When using DECtape file structuring, parity 
and density are fixed at odd parity and 800 BPI recording density. 


Table 9-12 lists the Data Modes acceptable to the handlers and Table 
9-13 lists the I/O Macros and their responses. 
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Table 9-12 


MAGTAPE DATA MODES 


Data Modes 

Handler 1 

MTA 

MTC 

MTF 

IOPS ASCII 

X 

X 

X 

IOPS Binary 

X 

X 

X 

Image 

Alph anumeric 

X 

- 

- 

Image Binary 

X 

- 

- 

! Dump 

X 

- 

- 


Table 9-13 

MAGTAPE I/O FUNCTIONS 


Macro 

Handler 1 

MTA 

MTC 

MTF i 

. INIT 



Accept 

Acc 

ept 

.FSTAT 

Adcept 



i 

i 

.RENAM 



IllJ 

gal 



.DLETE 


r 





.RAND 

Illegal 



Ille 

gal 

. RTRAN 

Illegal 

1 




.SEEK 



Accept 



.ENTER 



Illegal 



.CLEAR 



Illegal 


r 

.CLOSE 



Accept 

Accept | 

•MTAPE 

Acce 

;pt 

Illegal 



• READ 



Accept 



.WRITE 

i 


Illegal 



.WAIT 



Accept 



. WAITR 

i 


Accept 



.TRAN 


' 

Illegal 


r 


Illegal = Illegal Function (I0PS6 Error) 
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9. 3. 6. 2 Device Dependent Characteristics - The first .INIT to a Magtape 
unit causes the system default parameters for track count, recording 
density, and parity to be assigned as follows: 

Parity odd Density 800 BPI 

Track Count - System Generated Default unless otherwise speci- 
fied in the CHANNEL Keyboard Command. (See Paragraph 8.9.3.) 

The following characteristics are unique to the operation of the A and 
C handlers in responding to the I/O Macros below: 

a. .INIT - Maximum I/O buffer size returned: 376 g (254^ g ). 

b. . MTAPE - MTA accepts REWIND and BACKSPACE RECORD sub- 

functions only. 

The following characteristics are unique to the operation of the MTF 
handler: 

a. .INIT - Returns standard buffer size of 377 g . 

b. .MTAPE - On functions 05, 06, and 07 (skip record, skip 

file, and skip to logical end-of-tape) , if the handler 
senses phycical end-of-tape, IOPS 65 is issued. 

c. .READ - Bad Tape and Data Late errors are considered un- 
recoverable and MTR issues IOPS 65 for them. 

d. .TRAN - Permits either the PDP-15 standard 18-bit transfer 
(both 7 and 9 track look like 7 track) or the industry stan- 
dard 9-track transfer. In true 9-track operation, entered 
by setting bit 6 of the CAL to 1, each 18-bit word is in- 
terpreted as two 8 bit bytes of data plus associated parity 
bits (which are set on output and checked on input by the 
hardware). Thus: 

A parity Byte A Byte B 



0 1 2-9 10-17 

B parity—"* 

9.3.7 Line Printer Handler 

9. 3. 7.1 General Description - LPA (541 g locations) is designed to 
operate both the 80 column and 132 column LP15 Line Printers. The 
handler accepts data in either IOPS ASCII or Image Alphanumeric data 
modes. Table 9-14 lists the various I/O Macros and the handler's 
response to them. 


Table 9-14 


RESPONSES TO LINE PRINTER I/O FUNCTIONS 


Accept 

Illegal 
(IOPS 6) 

Ignore 

. INIT 

.RAND 

. FSTAT 

.CLOSE 

. RTRAN 

.RENAM 

.WRITE 

.SEEK 

. DLETE 

.WAIT 

.READ 

.ENTER 

. WAITR 

.TRAN 

. CLEAR 



.MTAPE 
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9. 3. 7. 2 Device Dependent Characteristics - The following paragraphs 
describe characteristics which are unique to the Line Printer Handler 
in its response to certain I/O Macros and characters. 


a. . INIT - 1) Maximum I/O buffer size returned: 66g (54^g) 

for 132 column printers; 

44 8 ^ 36 10^ for 80 column P rinters - 

2) Output FORM Feed. 

3) Test Bit 6 of the .INIT CAL (see 6.7.6). 

If set, inhibit FORM Feed each 57-^q lines. 

(This bit is set by using a 5 rather than a 1 

* in the "dd" argument of the .INIT.) 

b. .CLOSE - Output a FORM Feed (if not inhibited in the .INIT). 

c. .WRITE - 1) Examine header word 0 in the user's I/O 

buffer as follows: 

Bit Meaning 

0 0 = Enter Single Line Mode 

1 = Enter Multiple Line Mode 

1-8 Contains Line Count for 

Multiple Line Mode 

14-17 Data Mode 

2 = IOPS ASCII 

3 = Image Alphanumeric 

2 \ Check the first character of the user's I/O 
buffer for the following vertical form con- 
trol characters, all of which are output 
by the FORTRAN IV Object Time System: 

014 FORM Feed 

020 Overprint 

021 Print every second line 

012 Line Feed 

To effect the Overprint function for FORTRAN 
users, it is necessary to simulate certain 
vertical form control characters. If the 
first character of a line is 012, 014, or 021, 
the handler automatically enters Multiple Line 
Mode (by setting bit 0 of the first word in 
the user's I/O buffer to 1) and prints two 
lines, the first line being the vertical con- 
trol character, and the second line being the 
actual data. If the first character is 020 
(overprint), it is replaced in the user's 
I/O buffer by 015 (Carriage Return) which 
does not affect the page position and both 
lines are printed. All other characters cause 
a Line Feed to be output from the handler's 
internal buffer followed by the line from the 
user's buffer. After output, any data in the 
user's I/O buffer which was changed (i.e., header 
word 0 or the first data word) is restored. 
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If the user intends to output to another device 
from the same I/O buffer (e.g., two sequential 
.WRITES) , a .WAIT should be used after the .WRITE 
referencing the Line Printer to permit the re- 
storation of any data which may have been replaced 
in the user's I/O buffer by LPA. 

3) Output in either Single Line Mode or Multiple 
Line Mode as applicable. 

4) Restore modified portions of the user's I/O 
buffer (if changed). 

d. Carriage Control Characters - The control characters in Table 
9-15, except horizontal TAB, cause line termina- 
tion, in both IOPS and Image Modes, except for 
special cases described under .WRITE above. 


Table 9-15 


LINE PRINTER CARRIAGE CONTROL CHARACTERS 


Character 

Action 

Line Feed C/3 12) 

Space one line 

VT (Vertical Tab) (013) 

Space 20 lines 

Form Feed (014) 

Move to top of form 

Carriage Return (015) 

Reset column count to zero (no 
implicit LINE FEED function) 

DLE (020) 


Space 30 lines 

DC1 (021) 

Refer to Appendix 

Space 2 lines 

DC 2 (022) 

\ A for alternate 

Space 3 lines 

DC3 (023) 

designations 

Space 1 line 

DC 4 (024) j 


Space 10 lines 

ALT MODE (175) 

Reset column count to zero (no 
implicit LINE FEED function) 

Horizontal 

Tab (011) 

Output sufficient number of spaces 
to position printer at column 9, 

17, 25,..., etc. This is not a 
line terminator and may occur any- 
where in the line. 


9.3.8 Card Reader Handler (CDB) 

9. 3. 8.1 General Description - CDB (770g locations) is designed to 
operate the CR03B card reader. The handler transmits data in IOPS 
ASCII mode only. As initially supplied, it interprets Hollerith code 
as punched in DEC 029 Card Code. CDB is also supplied in source form 
which can be assembled to produce a version of the handler which inter- 
prets Hollerith punched in DEC 026 Card Code 1 . Appendix F contains a 

'Refer to the SGEN manual Tor procedures for assembling and installing 
the 026 code version of CDB. 
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table of 029 and 026 Hollerith codes and the corresponding IOPS ASCII 
codes. Table 9-16 lists the handler's response to the various I/O Macros 

Table 9-16 


CARD READER I/O FUNCTIONS 


Macro 

Response 

• INIT 

Accept 

•FSTAT 

Ignore 

•RENAM 

Ignore 

. DLETE 

Ignore 

.RAND 

Illegal 

. RTRAN 

Illegal 

.SEEK 

Ignore 

.ENTER 

Illegal 

.CLEAR 

Illegal 

.CLOSE 

Accept 

.MTAPE 

Ignore 

.READ 

Accept 

.WRITE 

Illegal 

.WAIT 

Accept 

. WAITR 

Accept 

.TRAN 

Illegal 


Illegal “ Illegal Function (IOPS6 Error) 


9. 3. 8. 2 Device Dependent Characteristics - The following paragraphs 
describe the characteristics which are unique to the Card Reader Handler 
in its response to certain I/O Macros. 


a. . INIT - Maximum I/O buffer size returned: 44g (36^^) 

b. .READ Eighty card columns are read and interpreted 

as 029 or 026 Hollerith data, mapped into the 
corresponding 64-graphic subset of ASCII, and 
stored in the user's I/O buffer in 5/7 format 
(36-.-. locations are required to store an 80 
column card) . Compression of internal blanks 
to tabs and truncation of trailing blanks is 
performed (all 80 characters appearing on the 
card are delivered to the user's buffer). In 
addition, a Carriage RETURN (015) character is 
appended to the input line; thus, a total of 81 
characters are returned to the user. 
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c. Illegal punch configurations - all illegal punch configura- 

tions (i.e., those not appearing in the 029 or 
026 character set shown in Appendix F) are in- 
terpreted as validity errors and will cause an 
IOPS 4 error condition. The card containing 
the error must be repunched. 

d. Special Codes - In addition to the Hollerith character set, 

the handler recognizes the ALT MODE terminator 
which is necessary for some system programs. 

ALT MODE, reaognized as a 12-8-1 code (multiple- 
punched A8) is mapped in to the standard ALT 
MODE character (175) in the user’s buffer. 

Each file must be terminated with an EOF card 
punched in either of two ways: a) multiple 
punch the characters +-0123456789 which punches 
all positions in card column 1, or b) multiple 
punch characters Aj H- which produces a 12-11-0-1 
punch in card column 1 . 


NOTE 

The card reader handler used when the system is 
operated in Command Batching Mode (described in 
paragraph 8.12) is a separate handler similar to 
CDB , but resident in the Monitor itself. As in- 
itially supplied, it :interprets cards punched in 
DEC 029 Hollerith Code. Another version, which 
recognizes DEC 026 Hollerith Code can be in- 
stalled into the system using procedures 
contained in the SGEN Manual. 


9.3.9 VP15A Storage Tube Display (VPA) 


VPA (1213g locations) operates the VP15A Storage Tube Display. It 
accepts data in IOPS ASCII, Image Alphanumeric and Dump Modes. In 
IOPS ASCII and Image Alphanumeric Modes, up to 70g (56.^) 72-character 
lines can be displayed. In Dump Mode, the handler interprets each 
18-bit data word as a coordinate for point plotting operations. 


Two versions of VPA are provided. The version installed in the system 
as initially supplied (1144g locations) automatically erases the screen 
when an attempt is made to display the 57th ASCII line and that line 
is placed at the top of the screen. The other version of VPA, which 
has a file name VPA.S, is slightly larger (1211g locations). It per- 
mits the user to operate the display in a "paging" mode by setting AC 
switch J 1 (when set to 1) to inhibit further output once the 56th ASCII 
line is displayed. Operation is resumed by pressing the ERASE push- 
button. Paging is stopped by resetting AC switch 0 to 0. 1 

1 Refer to the SGEN Manual for procedures for installing the VPA.S ver- 
sion of VPA. 
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Table 9-17 lists the handler's response to the various I/O Macros. 
The user should refer to the VP15A Graphics Software Manual (DEC-15- 
UXSB-D) for a detailed description of the handler's capabilities and 
programming considerations. 


Table 9-17 


VP15A DISPLAY I/O FUNCTIONS 


Macro 

Response 

. INIT 

Accept 

•FSTAT 

Ignore 

.RENAM 

Ignore 

. DLETE 

Ignore 

.RAND 

Illegal 

.RTRAN 

Illegal 

.SEEK 

Illegal 

.ENTER 

Ignore 

.CLEAR 

Ignore 

.CLOSE 

Accept 

.MTAPE 

Ignore 

.READ 

Illegal 

•WRITE 

Accept 

.WAIT 

Accept 

. WAITR 

Accept 

.TRAN 

Illegal 


Illegal = Illegal Function (I0PS6 Error) 
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CHAPTER 10 
OPERATING PROCEDURES 

10 . 1 INTRODUCTION 

This chapter provides general operating procedures and considerations 
to assist novice users in operating in the DOS-15 Monitor environment 
Procedures for system startup and system generation are the subject 
of Chapter 7 and are not included here. The discussions and examples 
in this chapter assume a properly configured and running system. It 
is assumed that the reader is familiar with the keyboard commands, as 
defined in Chapter 8. Further, the user should be aware of the dif- 
ferent types of I/O device handlers and their versions, as described 
in Chapter 9, and in particular, the tables which list those handlers 
which can be used with the DOS-15 System programs. 

Specific operating procedures for the system programs (i.e., command 
strings, options, functions, error messages, and so on) are provided 
in the various language and utility program manuals listed in the 
Preface. Once a user gains some understanding of the use of the sys- 
tem programs and their commands fr6m these manuals, he will find that 
the DOS- 15 Keyboard Command Guide (DEC-15-NGKA-D) provides most of 
the information normally required for day-to-day user reference. 

Since most procedures involved with keyboard operation are specific 
to particular programs, very little will be said here about them. 

In general, keyboard operations at the Monitor level consist of 
issuing commands to set up system operation, prior to calling system 
and user programs. This usually involves at least the LOGIN and 
LOGOUT commands, and quite often requires the PIP program, as well. 

This chapter consists primarily of two large examples of what might 
be typical DOS-15 operations. Each example is the result of an 
actual session at the PDP-15. On the left side of each page of the 
examples is the actual teleprinter output. All commands typed by 
the user are underlined. On the right is a running commentary on 
all significant teleprinter lines. 

10.2 EXAMPLE OF KEYBOARD OPERATIONS 

Figure 10-1, Example of DOS-15 Keyboard Operating Procedures, demon- 
strates some typical keyboard procedures. The example consists of 
a series of operations in which a simple FORTRAN program is trans- 
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ferred to the disk from DECtape, edited, compiled run, and trans- 
ferred back to DECtape. Figure 10-2, Listing of Sample FORTRAN Pro- 
gram, shows the program. The program simply prints the numbers 1 
through 10 on the device associated with .DAT slot 4, and then returns 
control to the Monitor. Figure 10-3 shows the teleprinter output, 
wi thout comment . 


>T C 


DOS-15 VIA 

ENTER DATE (MM/DD/YY) - 11/2/71 


SLOGIN JOE 


$ PIP 

DOSPIP V6A 
>L TT«-DK 


02-NOV-71 

DIRECTORY LISTING (JOE) 


1 660 

FREE 

BLKS 


13 

USER 

FILES 


362 

USER 

BLKS 


DKECH0 

001 

6 

02-NOV-7 1 

T 

001 

3 

02-NOV-71 

T 

002 

1 

02-NOV-7 1 

lef 

SRC 

106 

02-NOV-7 1 

JOB 

BIN 

15 

02-NOV-7 1 

AL 

SRC 

1 1 

02-NOV-7 1 

AL 

BIN 

3 

02-NOV-7 1 

MAX 

045 

3 

02-NOV-7 1 

ACCT 

654 

3 

02-NOV-7 1 


>T DK «-DT FTNTST SRC 


The user types CTRL C to prepare 
the Monitor for keyboard command 
input. If no response, the Monitor 
must be reinitialized using the 
bootstrap -- see Chapter 7. 


If the Monitor requests a date (in- 
dicating it has just been started 
via the bootstrap) enter it as re- 
quired. Otherwise check the date 
(type D) ) to make sure it is cur- 
rent ana correct it if it is not. 


If the user wishes to use disk 
storage, he must log-in to the 
Monitor with a UIC of his creation. 


At this point, the user might con- 
sider typing other commands such 
as: VT ON, KEEP ON, X4K ON, PROTECT 
etc. (refer to Chapter 8) . 


Call PIP 


Request a User File Directory 
listing to see if there is enough 
space available for the operations 
to be performed. (Since there 
are 5323 blocks indicated, the 
user can continue. If enough 
space were not available, however, 
other files in the UFD would have 
to be deleted.) 


If the user had no previous UFD 
on the disk, he would create one 
using the PIP command 

J 

Transfer program (FTNTST SRC) 
from user's DECtape to disk. 


Figure 10-1 

Example of DOS-15 Keyboard Operating Procedures 
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>tC 




Return to the Monitor 

DOS-! 5 
$R EDIT 

VIA 



Examine the .DAT/.UFDT slots 
for the EDITOR for proper 

.DAT 

DEVICE 

UIC 

USE 

assignment (no change required 

-15 

DKA 

JOE 

OUTPUT/SCRATCH in this case) . 

-14 

DKA 

JOE 

I/O 


-10 

TTA 

JOE 

SECONDARY 

INPUT 

$EDI T 




Call the EDITOR to correct any known 
errors on the file program prior to 
assembly or compilation. (In this 

case the FORTRAN comment line • 





descriptor "C" was missing and must 
be inserted. 

EDITOR 

V18A 




1 >0PEN FTNTST 



Open the file for editing. 

EDIT 
>P 4 




Locate error (i.e., print some lines) 


EXAMPLE 

- SAMPLE FORTRAN 

TEST PROGRAM Error line (the com- 

c 




ment descriptor "C" 
is missing) 

>T 




Go back to the top of the file. 

>N 2 




Point to the error line. 

tP 




Print it out as added precaution. 

EXAMPLE 

- SAMPLE FORTRAN 

TEST PROGRAM 

>c //c/ 




Add the "C" to the 

c 

EXAMPLE 

- SAMPLE FORTRAN 

TEST PROGRAM beginning. 

>CL0SE 




Close the file 

EDITOR 

VISA 




>tc. 




Return to the Monitor. 

DOS-15 

VIA 




$R FA 



USE 

Examine the . DAT/UFDT slots for the 
FORTRAN compiler for proper assign- 

.DAT 

DEVI CE 

UIC 

ment. (In this case the user wished 

-13 

DKA 

JOE 

OUTPUT 

to have his listing on the tele- 

-12 

TTA 

JOE 

LISTING 

printer, rather than the line 

-1 1 

DKA 

JOE 

INPUT 

printer. ) 

Sfl TT - 

12 



Assign the teleprinter to .DAT-12. 







Figure 10-1 (Cont. ) 


Example of DOS-15 Keyboard Operating Procedures 
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Call FORTRAN Compiler. 


F4X V28A 
>L,R«-FTNTST 


Issue command string. 


END PASS 1 

001 C 

002 C 

003 C 

004 

005 1 

006 10C 

007 

008 

F4X V28A 
>tC 

DOS-15 VIA 


Program listing output begins, 

EXAMPLE - SAMPLE FORTRAN TEST PROGRAM 

DO 1 1=1,10 
WRITE (4,100)1 
FORMAT ( 6X , 1 3 ) 

STOP 12345 
END 

Compilation complete. 

Return to the Monitor. 


$R USER 


.DAT 

DEVICE 

UIC 

+ 1 

DKA 

JOE 

+2 

DKA 

JOE 

+3 

DKA 

JOE 

+4 

TTA 

JOE 

+5 

PRA 

Ji£ 


Examine the .DAT/UFTD slots for 
available user programs. (This 
program uses .DAT slot 4 as refer- 
enced in the FORTRAN WRITE state- 
ment in the listing above.) 


CTRL P typed to abort remainder of 
typeout. 


$ A TT 4 
SGLOAD 

BLOADER VI 2A 
>*-FTNTST 


1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

STOP 012345 


DOS- 15 VIA 


DOSPIP V6A 


I0PS4 tR 


Assign the teleprinter to .DAT 
slot 4. 

Call the Linking Loader (load and 
go command . 

Give command string. 


Program is loaded and execution 
begins . 


End of program execution. The 
Monitor is called automatically by 
the FORTRAN STOP statement. 

Call PIP. 


Transfer edited source file from 
disk to DECtape. 

Device Not Ready error - the user 
forgot to WRITE ENABLE the DECtape 
unit. 


Figure 10-1 (Cont.) 





>L TTVDK 



Request User File Directory listing 





to examine the contents after cur- 

02 

-NOV- 

71 


rent series of operations. 

DIRECTORY LISTING 

(JOE) 


1056 

FREE 

BLKS 



15 

USER 

FILES 



364 

USER 

BLKS 



DKECHO 

001 

6 

02-NOV-71 


T 

001 

3 

02-NOV-71 


T 

002 

1 

02-NOV-7 1 


LEF 

SRC 

106 

02-NOV-71 


JOB 

BIN 

15 

02-NOV-7 1 


AL 

SRC 

1 1 

02-NOV-71 


AL 

BIN 

3 

02-NOV-7 1 


MAX 

045 

3 

02-NOV-7 1 


FTNTST 

SRC 

1 

02-NOV-71 


FTNTST 

BIN 

1 

02-NOV-71 


>D DK FTNTST 

_ SRC 


Delete source file (User decides to 





keep only his binary file on the 
disk) 

»tC_ 




Return to the Monitor. 

DOS- 15 
SL0G0UT 

VIA 



Current session at the computer is 
completed. User logs-out. 


Figure IQ-1 (Cont. 

Example of DOS-15 IKeyboard Operating 
Proc4«3ure 


001 

C 


002 


EXAMPLE - SAMPLE FORTRAN TEST PROGRAM 

>01I< 

-4 

(diagnostic ) 

003 

C 

004 


DO 1 1=1,10 

005 

1 

WRITE (4,100)1 

006 

100 

FORMAT (6X,I3) 

007 


STOP 12345 

008 


END 


Figure 10-2 

Listing of Sample FORTRAN Program 
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DOS-15 

VIA 



ENTER 

DATE C MM/DD/YY) - 11/2/71 

SLOGIN 

JOE 



SPIP 




DOSPIP 

V6A 



>L TT«-DK 



02 

-NOV-71 



DIRECTORY LISTING 

(JOE) 

1660 

FREE BLKS 


13 

USER FILES 


362 

USER BLKS 


DKECHO 

001 

6 

02-NOV-7 1 

T 

001 

3 

02- NOV-71 

T 

002 

1 

02-NOV-7 1 

LEF 

SRC 

106 

02-NOV-7 1 

JOB 

BIN 

15 

02-NOV-71 

AL 

SRC 

11 

02-NOV-71 

AL 

BIN 

3 

02-NOV-7 1 

MAX 

045 

3 

02-NOV-71 

ACCT 

654 

3 

02-NOV-7 1 

►T DX «-DT FTNTST 

“ SRC 


>tc 




DOS-15 

VIA 



$R EDIT 




.DAT 

DEVICE 

UIC 

USE 

-15 

DKA 

JOE 

OUTPUT/SCRATCH 

-14 

DKA 

JOE 

I/O 

-10 

TTA 

JOE 

SECONDARY INPUT 

$EDIT 




EDITOR 

VISA 



>0PEN FTNTST 



EDIT 




>P 4 




C 





EXAMPLE 

- SAMPLE FORTRAN TEST PROGRAM 

C 





Figure 10-3 

Uncommented Listing of Keyboard Operating Session 
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>1 

>N 2 
>P 





EXAMPLE 

- SAMPLE 

FORTRAN 

TEST 

PROGRAM 

>C //C/ 

C EXAMPLE 

>CL0SE 

- SAMPLE 

FORTRAN 

TEST 

PROGRAM 

EDITOR V! 8A 
>TC 





DOS-15 VIA 
$R F4 





.DAT DEVICE 

UIC 

USE 



-13 DKA 

JOE 

OUTPUT 



-12 LPA 

JOE 

LISTING 



-11 DKA 

JOE 

INPUT 



$A TT -r2 





$F4 





FAX V28A 
>L ,B«-FTNTST 





END PASS 1 

001 C 





002 C 

EXAMPLE 

- SAMPLE 

FORTRAN TEST PROGRAM 

003 C 

004 

DO 1 Irl 

,10 



005 1 

WRITE (4 

,100)1 



006 100 

FORMAT C6X,I3) 



007 

STOP 12345 



008 

F4X V28A 
>tC 

END 




DOS-15 VIA 
$R USER 





.DAT DEVICE 

UIC 




+ 1 DKA 

JOE 




+2 DKA 

JOE 




+3 DKA 

JOE 




+4 LPA 

JOE 




+5 PRA 

$A TT 4 

«-ztp 




$GL0AD 






Figure 10-3 (Cont.) 

Uncommented Listing of Keyboard Operating Session 
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RLOADER V12A 
><-FTNTST 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

STOP 012345 


DOS-15 VIA* 

$PIP 

DOSPIP V6 A 

>T DT«-DK FTNTST SRC 
IOPS4 tp 


>L TT-DK 

1 6-N0V-7 1 


DIPECTOPY LISTING (JOE) 


1525 

FREE 

BLKS 


13 

USER 

FILES 


161 

USEP 

BLKS 


DKFCHO 

001 

6 

16-N0V-71 

T 

001 

3 

1 6- NOV-7 1 

T 

002 

1 

16-N0V-71 

LEF 

SRC 

106 

1 6-N0V-7 1 

JOR 

PIN 

15 

1 6-N0V-71 

AL 

SRC 

1 1 

1 6-N0V-7 1 

AL 

BIN 

3 

1 6-N0V-7 1 

MAX 

045 

3 

1 6-N0V-7 1 

ACCT 

654 

3 

1 6-N0V-7 1 

FTNTST 

BIN 

1 

16-N0V-71 

FTNTST 

SRC 

1 

1 6-N0V-7 1 


>D DK FTNTST SRC 


>tC 

DOS-15 VIA 

SLOGOUT 


t 


Figure 10-3 (Cont.) 

Uncommented Listing of Keyboard Operating Session 
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10.3 EXAMPLE OF OPERATING PROCEDURES USING COMMAND BATCHING MODE 

The example which is contained in Figure 10-4 demonstrates typical 
operations using the Monitor's Command Batching Facility. Figure 
10-5 contains just the console teleprinter output without comment. 
Essentially the same types of operations which can be performed at 
the keyboard can be accomplished using Command Batching Mode. There 
are, of course, some operations which, although legal, are more dif- 
ficult to accomplish, such as editing. To prepare a job for Command 
Batching Mode, the Programmer creates a file of keyboard commands 
in the sequence in which they would normally be issued from the tele- 
printer, interspersed with the special batching commands described in 
paragraph 8-12 (as applicable) . The file can exist either on punched 
cards or paper tape. The programmer then submits the batch file and 
other required data (DECtapes, Magtapes, etc. for use during the job 
run) to the computer operator for execution along with appropriate 
instructions. Users who prepare batching files on punched cards 
should remember to place an end-of-»file card at the end of the card 
deck. This card is created by multiple punching all punch positions 
in card column 1 (see 9.3. 8.1 d) . 

The example below is basically similar to that in 10.2 except that 
no editing is performed since it is more easily and accurately ac- 
complished by the programmer directly. Similarly, requests for de- 
vice assignments were also omitted since this information cannot be 
utilized at runtime in a batching environment. 
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$tC 


The operator types CTRL C to pre- 
pare the Monitor for keyboard com- 
mand input. 

SBATCH PP 


Instruct the Monitor to enter Com- 
mand Batching Mode with the paper 
tape reader as the batching input 
device (the batch tape has already 
been loaded in the reader). 

DOS-15 VIA 


The Monitor reinitializes itself 


indicating it has entered Command 
Batching Mode. 

$$J0B TEST COMMAND BATCHING 

MODE 

$ JOB must be the first command on 



the batching medium. (The program- 
mer titles his batch run "TEST COM- 
MAND BATCHING MODE" . ) 

LOGIN JOE 


Log-in the UIC to be used. 

SLOG 

please MOUNT dectape 


The programmer uses the LOG command 

CONTAINING "FTNTST SRC" 

' ON 

to give instructions to the opera- 

DECTAPE UNIT 1 AND SET 


tor. 

TO WRITE ENABLE 

THANKS 

SSPAUSE 


The $PAUSE stops the job to permit 

tP 


the operator to comply with the 
instructions. The operator types 
CTRL R to continue operation. 

PIP 


Call PIP. 

DOSPIP VS A 

>T DK«-DT1 FTNTST SRC 


Transfer the file to be compiled to 
the user's disk file area, (it is 
assumed in this example that the 
user has already created a UFD for 
himself at some previous time) . 

>SJQB 


Return to the Monitor. 

DOS- 15 VIA 


Figure 10-4 

Example of Command Batching Mode 
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TT -L2 


Assign teleprinter to .DAT slot -12 
(user should know standard assign- 
ments for his system) to permit 
PORTRAN listing to be output to it. 

$F4 


Call the FORTRAN Compiler. 

FAX V28A 
>L,B.*-FTNTST 


Issue command string. 

END PASS1 

001 C 

002 C 

003 C 

004 

005 1 

006 100 

007 

008 

F4X V28A 

EXAMPLE - SAMPLE 

DO 1 1=1,10 

WRITE (4,100)1 
FORMAT (6X, I 3) 
STOP 12345 

END 

Program listing output begins. 

FORTRAN TEST PROGRAM 

Compilation ends. 

>$J0R 

DOS- 1 5 VIA 


Return to the Monitor . 

$A TT 4 

S6L0AP 

RLOADER V12A 
>«-FTNTST 


Assign the teleprinter to .DAT 
slot 4 (the user wants his program 
to use the teleprinter rather than 
device normally assigned to .DAT 4), 
Call the Linking Loader (load and 
go command) . 

Issue command string. 

1 

2 

3 

4 

5 

(5 


Program is loaded and execution 
begins . 

7 

8 

9 

10 

STOP 012345 

DOS-15 VIA 
$$J0P 


End of program execution. The 
Monitor is called automatically by 
the STOP FORTRAN statement. 

PIP 

DOSPIP V6A 


Call PIP. 

>T DT 1 «-DK FTNTST BIN 

Transfer the binary of the program 



just compiled to the user's DEC- 
tape for permanent storage. 


figure 10-4 (Cont.) 


Example of Command Batching Mode 
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>D DK FTNTST SRC 


Delete the source file from the UFD . 


>L TT«-DK 


02 

-NOV-71 


directory listing 

(JOE) 

1657 

FREE BLKS 


14 

USER FILES 


363 

USER BLKS 


DKECH0 

001 6 

02-NOV-7I 

T 

001 3 

02-NOV-71 

T 

002 1 

02-NOV-7 1 

LEF 

SPC 1 06 

02-NOV-71 

JOB 

BIN 15 

02-NOV-7 1 

FTNTST 

BIN 1 

02-NOV-7 1 

>L TT-DT1 


02-NOV-71 


DIRECTORY LISTING 


1066 

FREE BLKS 


2 

USER FILES 


10 

SYSTEM BLKS 


FTNTST 

SRC 1 

1 

FTNTST 

BIN 2 

1 

>$J0B 

DOS-15 

VIA 


^LOGOUT 

S$EXIT 



DOS-15 

VIA 



$ 


Request directory listing of user's 
disk area. 


Request directory listing of 
DECtape the user supplied with 
batch job. 


Batching run completed. Exit from 
Command Batching Mode. 


Figure 10-4 {Cont. ) 

Example of Command Batching Mode 


BATCH PR 
DOS-15 VIA 

SSJOB TEST COMMAND BATCHING MODE 
LOGIN JOE 

SLOG 

PLEASE MOUNT DECTAPE 
CONTAINING "FTNTST SPC" ON 
DECTAPE UNIT 1 AND SET 
TO WRITE ENABLE 
THANKS 
SSPAUSE 
tP 

PIP 

DOSPIP VGA 

>T DK*-DT1 FTNTST SRC 
*$J0B 

DOS-15 VIA 
$A TT -12 


Figure 10-5 

Uncommented Listing of Command Batching Mode 
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$F4 

F4X V2fiA 
*L,B, -FTNTST 


END PASS 1 

00 1 C 

002 C EXAMPLE - SAMPLE FORTRAN TEST PROGRAM 

003 C 

004 DO 1 1=1,10 

005 1 WRITE (4,100)1 

00fi 100 FORMAT ( GX , 1 3) 

007 STOP 12345 

00R END 

F4X V2.fi A 
>$JOR 

DOS-15 VIA 
SA TT 4 

SOLO AD 
LOADEP V12A 
>- FTNTST 

1 

2 

3 

4 

5 
fi 

7 

8 
9 

10 

STOP 012345 

DOS-15 VIA 

$$JOB 

PIP 

DOSPIP VfiA 

>T DT 1 »-DK FTNTST DIN 
>D D K FTNTST SRC 


»L TT-DK 


Ifi- 

NOV- 

71 


DIRECTORY LISTING 

(JOE) 

1 52S 

FREE 

BLKS 


12 

USER 

FILES 


160 

USER 

BLKS 


DKFCHO 

001 

fi 

16-N0V-7 1 

T 

001 

3 

lfi-NOV-71 

T 

002 

1 

1 6-N0V-7 1 

LEF 

SRC 

10fi 

1 6-N0V-7 1 

JOB 

BIN 

15 

1 6-N0V-7 1 

AL 

SRC 

1 1 

1 6-N0V-7 1 

AL 

BIN 

3 

1 6-N0V-7 1 

MAX 

045 

3 

1 S-NOV-7 1 

ACCT 

654 

3 

16-NOV-71 

FTNTST 

BIN 

1 

1 6-N0V-7 1 


Figure 10-5 (Cont.) 

Uncommented Listing of Command Batching Mode 
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>L TT-DT1 


16' 

-NOV-71 


DIRECTORY LIFTING 


1060 

FREE BLKS 


3 

USER FILES 


10 

SYSTEM BLKS 


FTNTST 

SRC 3 

1 

FTNTST 

BIN 4 

1 

DKECHO 

001 2 

e 

$$J0B 



LOGOUT 



$SEXIT 



DUS- 15 

VIA 


$ 




Figure 10-5 (Cont.) 

Uncommented Listing of Command Batching Mode 


10.4 ERROR DETECTION AND RECOVERY PROCEDURES 

All major conqponents of the DOS-15 Software System contain facilities 
for error detection and operator notification. This includes the 
System Programs, I/O Device Handling Routines and The Monitor itself. 
The operator is notified of the existence of an error condition most 
generally by a message output to the console teleprinter. There are, 
however, two situations in which the operator would not receive a 
message on the teleprinter. The first is the normal occurrence of 
end-of-file, end-of-medium, parity and checksum error conditions by 
means of the information fields provided in header word 0 of the 
affected logical record. Recovery from these errors is not discus- 
sed here, since it is the user's program which must recognize these 
conditions and determine the appropriate corrective action. (Refer 
to paragraph 6. 3. 1.1). The second feituation is the occurrence 
of an undetected error such as a user's program looping endlessly 
within itself. Under these conditions, the user can only detect the 
error condition by observing that the program is not operating as 
expected. His only recourse in this case is to abort the operation 
by typing CTRL C or CTRL Q. 
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There are two types of error messages output to the console teleprint- 
er: 

o I/O errors which are detected by the I/O device handlers 

and printed through the Monitor's error message facility. 
These messages, referred to as "IOPS errors", consist of 
the mnemonic "IOPS" followed by a number. 

o System Program and Monitor detected errors which generally 

result from syntactically incorrect or illogical command 
strings or other illegal operating conditions. These 
messages are generally self-explanatory and consist of an 
appropriate symbol, word, phrase or sentence. 


The degree to which IOPS error recovery is possible can vary with 
the nature of the error. In some situations, it may be possible to 

continue the operation from the point where it was interrupted by 

the error message. For example, the I0PS4 message (I/O Device Not 
Ready) occurs when an I/O device hardware not ready condition is 
detected by the handler. To recover, all that is required is that 
the operator correct the condition (e.g., card reader out of cards) 
and type CTRL R. The operation will continue as if the error had 
never occurred. In other situations the operator may have to retype 
a command string correctly, restart the interrupted program (CTRL P) 
or call in the Monitor (CTRL C) to reassign an I/O device or to re- 
load the program. Some users may wish to save an image of the core 
at the time of the error. In that case, the QDUMP command (see 
8.7.2) would be typed before reloading the offending program. If, 
after typing CTRL C, the Monitor does not start up because a run- 
away program has destroyed the bootstrap, the bootstrap must be re- 
initialized or reloaded using procedures described in Chapter 7. 

Complete identification, explanation and recovery information for 
IOPS errors is provided in Appendix D. Similar information for 
other error messages is found in the applicable language or utility 
program manual for the applicable System Program. The DOS-15 Key- 
board Command Guide, DEC-15-NGKA-D, provides complete command sum- 
maries of all DOS-15 System Program and IOPS error messages. 
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APPENDIX A 


PDP-15 IOPS ASCII STANDARD CHARACTER SET 

The table below shows the 7-bit ASCII characters intepreted by the 
DOS-15 Monitor and System Programs either as meaningful data and com- 
mand input or as control characters. The 7-bit octal code and the 
corresponding graphic characters conform to the standard ASCII 1968 
64-character graphic subset. 

The control characters (codes 00-37, and 175-177) are used for system 
control purposes. The characters shown in brackets [] are not used 
by the system and are available for user applications. Characters in 
parentheses denote the 1963 character set. 


7-BIT 


ASCII 

7-BIT 

ASCII 

7-BIT 

ASCII 

7-BIT 

ASCII 

CODE 


CHAR. 

CODE 

CHAR 

CODE 

CHAR. 

CODE 

CHAR. 

000 

NUL 



040 

SP 

100 

<3 

140 

Not 

001 


SOH 



041 

1 

101 

A 

* 

recognized 

002 


STX 



042 

II 

102 

B 

174 

by DOS- 15 

003 

ETX 

(CTRL C) 

043 

# 

103 

C 

175\ 


004 

EOT 

(CTRL D) 

044 

$ 

104 

D 

176/ 

ALT MODE 

005 


ENQ 


045 

% 

105 

E 

177 

DEL (rubout) 

006 


ACK 


046 

& 

106 

F 



007 


BELL 


047 

1 

107 

G 



010 


| BS 

J 


050 

( 

110 

H 



Oil 

HT 



051 

) 

111 

I 



012 

LF 



052 

* 

112 

J 



013 

VT 



053 

+ 

113 

K 



014 

FF 



054 

/ 

114 

L 



015 


CR _ 



055 

- 

115 

M 



016 


so 



056 


116 

N 



017 


Lsi 



057 

/ 

117 

0 



020 

DLE 

(CTRL P) 

060 

0 

120 

P 



021 

DC1 

(CTRL Q) 

061 

1 

121 

Q 



022 

DC 2 

(CTRL R) 

062 

2 

122 

R 



023 

DC 3 

(CTRL S) 

063 

3 

123 

S 



024 

DC 4 

CTRL T) 

064 

4 

124 

T 



025 

NAK 

(CTRL U) 

065 

5 

125 

U 



026 


r SYN j 


066 

6 

126 

V 



027 


| ETB | 


067 

7 

127 

W 



030 

CAN 

(CTRL X) 

070 

8 

130 

X 



031 


r EM 

1 


071 

9 

131 

Y 



032 


I SUB | 


072 

• 

132 

Z 



033 

ESC 

(ALT MODE) 

073 

t 

133 

[ 



034 


FS 



074 

< 

134 

\ 



035 


GS 



075 

SB 

135 

1 



036 


RS 



076 

> 

136 

" ( + ) 



037 


US 



077 

? 

137 

(«- 



NOTES : 

1. Codes 33, 175 

and 176 are interpreted as 

ESC (ALT MODE) and I 


are 

converted 

on input to 175 by IOPS. 




2. The 

left bracket, backslash, and right bracket 



(i.e 

• • If \ #and ]) characters are formed by typing 


SHIFTS K, L, 

and M, 

respectively . 
























APPENDIX B 


SAMPLE IOPS ASCII PACKING AND UNPACKING ROUTINES 

This appendix contains two subroutines for use in packing and unpack- 
ing IOPS (5/7) ASCII. These routines are self-contained and can be 
incorporated in user programs directly or contained in the DOS-15 
System Library (.LIBR BIN) or userrcreated library and referenced 
globally (.GLOBL pseudo-op). If they are to be incorporated direct- 
ly into a program, the .GLOBL and .END pseudo-ops must be removed. 

Unpacking Routine 

This routine has two entry points, GT.FST AND GT.CHR. The GT.FST 
entry is used to initialize the routine for each unpacking sequence. 
Upon entry via GT.FST, the AC must contain the address of the first 
location in the buffer. (The routine automatically skips over the 
Header Word Pair.) On return the AC is unchanged. After initiali- 
zation, each entry via GT.CHR returns a 7-bit ASCII character right 
justified in the AC. The user program must detect the end of the 
logical record, normally by checking for a Carriage RETURN or 
ALT MODE terminator. Entry to the routine from the user program is 
made by either a JMS or a JMS* instruction as follows: 

If this routine is directly incorporated in the user's 
program: 

LAC ADDRESS /BUFFER ADDRESS 

JMS GT.FST /ENTRY TO INITIALIZE UNPACKING 

JMS GT.CHR /ENTRY TO UNPACK A CHARACTER 

If this routine resides in a library: 

.GLOBL GT.FST, GT.CHR/EXTERNAL GLOBL DECLARATION 


LAC ADDRESS /BUFFER ADDRESS 

JMS* GT.FST /ENTRY TO INITIALIZE PACKING 


JMS* GT.CHR /ENTRY TO UNPACK A CHARACTER 

DAC SAVCHR /SAVE CHARACTER RETURNED IN AC 



Packing Routine 


This routine also has two entry points, PK.FST and PK.CHR. The 
PK.FST entry is used to initialize the routine for each new packing 
sequence. Upon entry via PK.FST, the AC must contain the address of 
the first location in the buffer (the routine ignores the header word 
pair automatically); on return, the AC is unchanged. After initializa- 
tion, each entry via PK.CHR with a character in the AC will pack that 
character in 5/7 format. The characters to be packed must be right 
justified in the AC. On return to the user, the AC will still con- 
tain that character, however, bits 0-10 of the AC will be set to zero. 
The user program must detect the end of the logical record, normally 
by testing for a terminator such as Carriage RETURN or ALT MODE. 
Further, the user must also set up the header word pair for the 
logical record. Entry to the packing routine is made from the user's 
program either by a JMS or JMS* instruction as follows: 

If this routine is directly incorporated in the user's 
program: 

LAC ADDRESS /BUFFER ADDRESS 

JMS PK.FST /ENTRY TO INITIALIZE PACKING 


LAC CHAR /CHARACTER TO BE PACKED 

JMS PK.CHR /ENTRY TO PACK A CHARACTER 

If this routine resides in a library: 

. GLOBL PK.FST, PK.CHR /EXTERNAL GLOBL DEFINITION 


LAC ADDRESS /BUFFER ADDRESS 

JMS* PK.FST /ENTRY TO INITIALIZE PACKING 


LAC CHAR /CHARACTER TO BE PACKED 

JMS* PK.CHR /ENTRY TO PACK A CHARACTER 
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/I OPS ASCII UNPACKING SUBROUTINE 
/ 

/GT ,rST— INITIALISE 5/7 .ASCII UNPACKING, ON FNTRy 
/AC COf 1 TAINS ADDRESS OF I/O BUFFER TO BE 
/UNPACKED, ON return AC IS RESTORED, 
/GT.CHR-AFTER 5/7 .ASCII UNPACKING HAS BEEN 
'INITIALISED BY GT.FST, GT.ChR WILL RETURN 
/SUBSEQUENT CHARACTERS IN AC. 

/ 



.GLORL 

GT ,FST, GT.CHR 


GT.FST 

** 


/INITIALIZE 


nAC 

GT , TMP 

/SAVE AC 


TAO 

12 

/SET BUFFER POINTER 


DAC 

GT.PTR 

/TO SKIP OVER HEADER WORD PAIR 


law 

• 1 

/CHARACTER COUNTER 


nAC 

G T , 5 



LAC 

' GT , T«P 

/RESTORE AC 


jMP* 

GT.FST 


CT , CUR 

'i 




IS? 

G T , 5 



JMP 

GT , MO 

/WORD PAIR STARTrD 


L AC* 

GT , ptr 

/NEED NEXT PAIR 


IS? 

gt.ptr 



nAC 

gt.wdi 

/first part 


lac* 

gt.ptr 



IS? 

gt.ptr 



DAC 

GT.WD2 

/SECOND PART 


law 

17773 

/reset character counter, 


DAC 

GT ,5 


ST, MO 

law 

17770 

/SHIFT LOOP TO 7 1/2 TIMES 


DAC 

GT ,WD3 


r.T.LUP 

LAC 

GT.WD2 



PAL 




IS2 

GT ,WD3 



JMP 

GT.MOR 



AND 

L177 

/GOT CHARACTER 


SAD 

SPACE 

/IF SPACE DONT UPDATF GT.LST 


jMP 

GT , EXT 


GT.EXT 

JMP« 

GT.CHR 

/EXIT 

r, T , m 0 R 

DAC 

GT.W02 



lac 

GT.WD1 



RAL 




0 AC 

GT.KDl 



JMP 

gt.lup 

/BACK TO LOOP 

OT.PTR 

0 



CT.5 

fl 



OT.WOl 

n 



gt.wdz 

flt 



ST , W03 

Q 



0 T , T Mp 

n 

/ 



12 

2 



I. 177 

177 



SPACE 

40 




.END 




B-3 



/ 1 OPS (5/7) ASCII PACKING SUBROUTINE 
/ 

/PK.rST -INITIALISE 5/7 .ASCII UNPACKING. ON ENTRY 

/AC CONTAINS ADDRESS OF I/O BUFFER TO CONTAIN PACKED ASCII* 

/ON RETURN AC IS UNCHANGED. 

/PK.CHR IS mORMAL FNTRV POINT AFTER INITIALIZATION (PK,FsT), 
/AC CONTAINS CHARACTER TO BE PACKED, ON RETURN, AC CONTAINS 
/THE SAME CHARACTER BUT HIGH ORDER BITS (0-lt>> ARE ZEROED 


/OUT, 

/ 



. GLOPL 

PK.rST, 

PK.CHR 

SMAL = 660O0(7 



p K , F S T 

•jt 




0 AC 

ftLCHR2 



tad 

L2 



DAC 

KL p UTP 



OZm 

KL57 



DHm 

CHRCNT 



LAC 

KLCHR2 



JMP# 

PK.FST 


PK.CHR 

C 




ISZ 

CHRCNT 



and 

L177 



0 AC 

KLCHR2 



CLL 




LAC 

KL57 



TAO 

(JMP# KLJ57 


DAC 

.♦? 



LAC 

KLCHR2 



XX 



KLJS7 

KL571 

KL 5 7 ? 
KL573 
KL574 
KL575 



* L 5 7 1 

alsishal 

13 

< L 5 7 1 A 

DZM# 

klputp 



JMP 

KLN057 


KL 572 

ALSISHAL 

A 


JMP 

KLMQ97 


KL573 

RTR 




PAR 




AND 

117 



XOR# 

KLPUTP 



DAC* 

KLPUTP 



ISZ 

klputp 



lac 

KLCHR2 



ALSISHAL 

17 


JMP 

KL571A 


*L574 

ALSISHAL 

10 


JMP 

KLND57 


KL575 

RCL 




D2m 

KL57 



SKP 



KLND57 

IS? 

KLB7 



XOR* 

KLPUTP 



DAC* 

KLPUTP 



/INITIALIZE 
/SAVE AC 

/set klputp to buffer address *2 
/TO SKIP over header WORD PAIR 


/RESTORE AC 
/EXIT 


/CHAR POSITION, 


/MODIFIED JMP 

/CHARI 

/CHAR2 

/CHAR3 

/CHAR4 

/CHARS 

/11 left 

/CLEAR DATA uORD 
/ 4 LEFT 

/ 3 RIGHT-1ST HALF 


/LAST WORD OF FAfR, 
/2ND HALF 

/lb I EFT 

/a left 

'1 LEFT 

'Reset 5/7 counter 


B-4 



L AC 

KL57 


SNA 



I s? 

KLPUTP 

/2N0 WORD COMPLETE 

lac 

KLCHP2 


JMP* 

PK , CHH 

/exit, 


*157 0 

/LPUTP 7 
KLCHP2 0 
r-MRCNT H 
1.2 2 
Ll77 177 
117 17 

.END 


B-5 



APPENDIX C 


INPUT/OUTPUT DATA MODE TERMINATORS FOR SPECIFIC DEVICE HANDLERS 

NOTE: All Handlers determine the data mode from the .READ or .WRITE macro. Abbreviations 

and acronyms are defined at the end of the table. 


DATA MODE 

HANDLER 

INPUT 

OUTPUT 

TOPS ASCII 

DT 

Call versions) 

HWP, WC, whichever is smaller 

EOM, EOF 

HWP, EOM 

DK, DP 

Cal 1 ve rs io ns ) 

HWP, WC, whichever is smaller 

EOM, EOF, 

HWP, EOM 

CDB. 

WC, EOM, EOF 

Not applicable 

LPA . fS 9 

Not applicable 

HWP, CR, AM overflow lines will con- 
tinue on next line, with 
diamond as 1st character 

LPA.15 

Not applicable 

HWP, CR, AM, I OPS 37 on overflow 

VC 1 

MTA . 

HWP, WC whichever is smaller 

EOM, EOF 

HWP, EOM 

MTC . 

HWP, WC whichever is smaller 

EOM, EOF 

HWP, EOM 

MTF . 

WC, EOM, EOF 

HWP , EOM 

TTA. 

CR, AM, CTRL D, WC (no CR appended) 

HWP*, CR, AM, EOF 

PP 

Call versions) 

Not applicable 

HWP, CR, AM, EOM 

PR 

(all versions) 

WC, CR, AM, EOM, EOF 

Not applicable 

*HWP with word pair count less than two will cause carriage return/line feed only. If the word pair 
count is two or more, only a carriage return or an ALT MODE will terminate output. 











































DATA MODE 


HANDLER 


INPUT 


OUTPUT 


I I I 


IOPS Binary 

DT 

(all versions) 

HWP , WC whichever is smaller 

EOM, EOF 

HWP, EOM 

DK, DP 

Call versions) 

HWP, WC whichever is smaller 

EOM, EOF 

HWP, EOM 

CDB . 

Not applicable 

Not applicable 

LPA.09 

Not applicable 

Not applicable 

LPA.15 

Not applicable 

Not applicable 

MTA. 

HWP, WC whichever is smaller 

EOM, EOF 

HWP, EOM 

MTC. 

HWP , WC whichever is smaller 

EOM, EOF 

HWP, EOM 

MTF. 

WC, EOM, EOF 

HWP, EOM 

TTA. 

Not applicable 

Not applicable 

PP 

Call versions) 

Not applicable 

HWP, EOM 

PR 

Call versions) 

WC, EOM, EOF 

Not applicable 










































DATA MODE 

HANDLER 

INPUT 

OUTPUT 

IMAGE ALPHA/ 
IMAGE BINARY 

DT 

(all versions) 

HWP , WC ... 

EOM EOF whichever is smaller 

HWP, EOM 

DK, DP 

(all versions) 

HWP , WC ... . . . 

. ' ___ whichever is smaller 

EOM , EOF 

HWP, EOM 

CDB . 

Not applicable 

Not applicable 

LPA. 09 

Not applicable 

Not applicable for BIN 

HWP, CR, AM for ALPHA 

Overflow lines will continue 
on next line, with diamond 
as first character 

LPA. 15 

Not applicable 

Not applicable for BIN 

HWP, CR, AM, VC for ALPHA 

IOPS 37 if line is exceeded 

MTA . 

HWP , WC ... . , , 

EOM, EOF whichever is smaller 

HWP, EOM 

MTC. 

EOM, EOF whichever is smaller 

HWP, EOM 

MTF . 

WC, EOM, EOF 

HWP , EOM 

TTA . 

Not applicable for BIN 

CTRL D, WC for ALPHA 

Not applicable for BIN 

HWP 

PP 

(all versions) 

Not applicable 

HWP, EOM for BIN 

HWP, AM, CR, EOM for ALPHA 





PR 

(all versions) 


WC, EOM, EOF 


Not applicable 










































Input/Output Data Mode Terminatoi 


DATA MODE 
DUMP MODE 


HANDLER 

DT 

Call versions) 
DK, DP 

(all versions) 


CDB. 

LPA.09 

LPA.15 

MTA. 


MTC. 


MTF . 


TTA. 


PP 


PR 


List of Abbreviations and Acronyms; 


WC, 

EOM, 

EOF 

WC, 

EOM, 

EOF 


Not applicable 
Not applicable 
Not applicable 
WC, EOM, EOF 


Not applicable 


Not applicable 


Not applicable 


Not applicable 


WC , EOM 


Handlers : 

DT 

DEC tape 

DK, DP 

Disk (DECdisk or Disk Pack) 

CDB. 

The "B" Card Reader Handler 

LPA.09 

Line Printer Handler for PDP-9 users 

LPA.15 

Line Printer Handler for PDP-15 users 

MTA. 

Magtape "A" Handler 

MTC. 

Magtape "C" Handler 

MTF. 

Magtape "F” Handler 

TTA 

Teleprinter Handler 

PP 

Paper Tape Punch Handler 

PR 

Paper Tape Reader Handler 


for Specific Device Handlers (Cont. ) 

OUTPUT 

WC, EOM 

WC, EOM k 

Not applicable 

Not applicable 
Not applicable 

WC, EOM 

Not applicable 
Not applicable 
Not applicable 

WC , EOM 

Not applicable 


Abbreviations : 

AM ALT MODE key 

CR Carriage RETURN (RETURN) key 

EOF End-of-File 

EOM End-of-Medium 

HWP Header Word Pair's word pair count 

VC Vertical Control Character 

WC Word Count in an I/O Macro 





















APPENDIX D 


IOPS ERROR CODES 


Error Code 

Meaning 

Error Data Output 1 

0 

Illeqal CAL Function Code - The function code immedi- 
ately following the offending CAL instruction is not 
legal 

CAL address 

1 

CAL* Illegal - The Monitor does not permit execution 
of CAL* (.indirect) instructions 

CAL address 

2 

• DAT Slot. Error - 

a. The .DAT Slot number (bits 9-17 of the CAL) 

is either 0 or outside the range of , legal 
numbers established when the system 1 was 
created (at System Generation) . j 

b. No . IODEV has been issued for this .DAT Slot. 

CAL address 

3 

Illegal Interrupt -An interrupt originated from a de- 
vice when either its handler was not core resident or 
its handler was not previously initiali zed (via .INIT). 

Contents of the IORS word at 
the time of the interrupt .+ 

4 

Device Not Ready - 

al Device ’’OFF LINE", "WRITE PROTECTED" or Unit 
Number not selected. 

b. Line Printer or Paper Tape Punch out of paper. 

c. Line Printer Alarm Status 

d. Card Reader stacker full, mis-punched card, 
card jam, hopper empty, EOF card missing. 

e. 9-channel I/O request to 7-channel Magtape 
. transport (or vice versa) . 

Remedy error condition and type CTRL R to continue 
interrupted operation. 

Disk - CAL adr,dv & unit, CAL fcn r UIC 
Card Reader - dv, message 

Line Printer - dv 

Teleprinter - dv 

Magtape - CAL adr,dv,& unit, CAL fen 
Other - CAL adr 

5 ' 

Illeqal Setup CAL - A CAL to set up API/PI linkaqe was 
issued by a handler (as a result of a .INIT) when no 
skip IOT existed in the Monitor's Skip Chain for that 
device (IOTs are placed in the Skip Chain during System 
Generation. ) . 

CAL address 




tRefer to Chapter 3 of the PDP-15 User's Handbook. Vol. I Processor (DEC-15-H2DA-D) . 
















IOPS ERROR CODES {Cont. ) 


Error Code 

Meaning 

Error Data Output 1 

6 

Illegal Handler Function - A CAL has been issued 
to a handler which is incapable of performing 
that function (e.g. , .READ to the paper tape 
reader, .TRAN to the disk in the reverse direc- 
tion, etc. ) 

Disk - CAL adr,dv & unit, CAL fcn,UIC 
Card Reader - dv, message 

Line Printer - dv 

Teleprinter - dv - 

Magtape - CAL adr,dv & unit, CAL fen. 
Other devices - CAL address 

7 

Illegal Data Mode - 

a. A .READ or .WRITE was issued using a 

Data Mode unacceptable to the handler. 

b. An attempt was made to change transfer 
direction prior to issuing a new . INIT 
via that .DAT Slot. 

Disk - CAL adr,dv & unit, CAL Fen, UIC 
Card Reader -dv, message 

Line Printer - dv 

Teleprinter - dv 

Magtape - CAL adr,dv & unit, CAL fen 
Other devices - CAL address 

10 

File Still Active - Failure to close (.CLOSE) a 
file before another .SEEK, .ENTER, .RAND, .RENAM, 

. FSTAT , . DLETE or .CLEAR is issued via the same 
.DAT Slot. 

Disk - CAL adr,dv & unit, CAL fen, UIC, 
f ilnam 

Magtape - CAL adr,dv & unit, CAL fen 
DECtape - CAL adr 

11 

.SEEK/. ENTER/. RAND Not Executed - 

A .READ, .WRITE, or . RTRAN was issued to a direc- 
tor ied device vith no prior .SEEK/. ENTER/. RAND. 

Disk - CAL adr,dv & unit, CAL fcn,Uie 
Magtape - CAL adr,dv & unit, CAL fen - 
DECtape - CAL adr 

12 

Terminal Device Error - 

a. DECtape mark track error (tape must be 
reformatted) 

b. Magtape EOT encountered on space forward 

DECtape - The contents of device 
status register "B" (bits 0-11) and 
unit no. (bits 15-17) 

Magtape-CAL adr, dev & unit, CAL fen 

13 

File Not Found - The file name specified in the 

CAL argument (CAL+2) is not in the file directory 
of the device associated with the specified .DAT 
Slot (.SEEK, .ENTER, .RAND, .DLETE, .RENAM, .RAND). 

Disk - CAL adr,dv & unit, CAL fen, DIC, 
f ilnam 

Magtape - CAL adr 

DECtape - CAL adr 

14 

Directory Full - In response to a .ENTER the DEC- 
tape or MAGtape handler has determined that there 
is no space for another file name. 

Magtape - CAL adr 

DECtape - CAL adr 




TOPS ERROR CODES (Cont.) 


Error Code 

Meaning 

Error Data Output 1 

15 

Device Full - No space available on the device medium 
for data storage. 

Disk - CAL adr,dv & unit, CAL fcn,UIC, 
Magtape - CAL adr,dv & unit, CAL fen 
DECtape - CAL adr 

16 

Output Buffer Overflow - The word pair count on the 
current .WRITE is greater than 177g. (This error 
is obsolete and has been replaced by IOPS 23.) 

CAL adr 

17 

Too many Files for Handler - Too many files are cur- 
rently open on the bandler to be referenced by this 

CAL. (See handler descriptions in Chapter 9 
for limitations.) 

Disk - CAL adr,dv & unit, CAL fcn,UIC 
MAgtape - CAL adr,dv & unit, CAL fen 
DECtape - CAL adr 

20 

Disk Hardware Failure - 

Block no. ,dv & unit, CAL fen, UIC 

21 

Illegal Disk Address - An attempt was made to refer- 
ence a block number which was either 0 or greater 
than the maximum number of blocks available on the 
disk. 

Block no. ,dv & unit, CAL fen, UIC 

22 

Two Output Files on One Unit - An attempt was made 
to reference more than one output file concurrently 
on the same DECtape or Magtape unit. 

Magtape - CAL adr,dv & unit, CAL fen 
DECtape - CAL address 

23 

Illegal Word Pair Count - The word pair count in 
header word 0 of the logical record currently being 
transferred is either 0 or greater than 177g. 

Disk - CAL adr,dv & unit, CAL fen, UIC 
f ilnam 

Magtape - CAL adr,dv & unit, CAL fen 
Other devices - CAL adr. 

30 . 

API Software Level Error - An API break occurred to 
a software API level which did not have the appropri- 
ate transfer vector (s) setup in .SCOM+12 through 
. SCOM+15 . 

Contents of the API Status Register 

31 

Nonexistent Memory Reference - A nonexistent memory 
reference occurred with memory protect mode ON 

Program Counter 


without a user-defined violation routine. 





























IOPS ERROR CODES (Cont.) 


Error Code 

Meaning 

Error Data Output 1 

32 

Memory Protect Violation - A reference was made to 
a location in memory below the memory protect 
boundary without a user-defined violation routine. 

Program Counter 

33 

Memory Parity Error - A memory parity error occurred 
without a user-defined error routine. 

Program Counter 

34 

Power Fail Skip Not Setup - The power failure inter- 
rupt detected a power low condition with no user- 
defined service routine to save appropriate registers 

Program Counter 

37 

Print Line Overflow - The 81st or 133rd character 
(depending on the line printer type) of the line 
currently being output is not a legal terminator. 
(Carriage RETURN, ALT MODE, FORM Feed, LINE FEED, 
Vertical TAB, etc.). The remainder of the line is 
lost . 

CAL adr,dv 

40 

Header Label Error - Durinq the processing of a 
.SEEK to a Magtape file, the handler calculated file 
name does not agree with the name present in the 
file header label. 

CAL adr 

41 

Directory Format Error - Illegal or meaningless data 
was found in the Magtape file directory. 

CAL adr 

42 

Accessibility Map Overflow - During the processing 
of an .ENTER to the Magtape unit, the accessibility 
map is found to be full. (Too many files.) Use 

MTDUMP to delete unwanted files to obtain space. 

CAL adr 

43 

Directory Recording Error - The file directory of 
the referenced Magtape has been contaminated. 

Use MTDUMP to reformat the directory. 

CAL adr 








IOPS ERROR CODES (Cont.) 


Error Code 

Meaning 

Error Data Output 1 

44 

Loqical EOT Detected - The Magtape handler detected 
a logical End-of-Tape during the processing of a 
.SEEK or .ENTER. 

CAL adr,dv & unit, CAL fen 

45 

Long Input Record - The record being input from Maq- 
tape is too long for the handler's internal buffer 
(255.^0 words maximum) . 

CAL ^dr,dv & unit, CAL fen 

46 

Attempt to Delete A System File - An attempt has 
been made via a .DLETE to delete a file having a 
"SYS" extension (applies to Advanced Monitor System 
DECtapes only) . 

CAL address 

47 

Illeqal Horizontal Tab - An attempt has been made to 
issue a Horizontal TAB operation on the Line Printer 
which caused the column count to exceed the device's 
capacity for line length. 

CAL adr,dv 

51 

Illegal User File Directory - When performing Disk 

I/O: 

a. A .USER was issued using -1, ???, or @@@ as 
a UIC. 

b. A .SEEK was attempted to a nonexistent UFD. 

CAL adr,dv & unit, CAL fen, UIC 

55 

No Buffers Available - A .GTBUF Macro was issued from 
either a handler or a user program with an insuf- 
ficient number of buffers allocated (see BUFFS 
command, paragraph 8.6.1). 

CAL adr,dv & unit, CAL fen, UIC 

61 

Parity Error in Directory or File Bit Map - Defective 
data, device medium, or hardware (see Recovery pro- 
cedure for DECtape in note 2 below) . 

Disk - CAL adr,dv & unit, CAL fen, UIC 
DECtape - CAL address 

63 ’ 

' 

Protected User File Directory - Attempt to 
create (.ENTER) or delete (.DLETE) a file 
in a protected directory (see 9.3.5). 

CAL adr,dv & unit, CAL fen, UIC 


























IOPS ERROR CODES (Cont.) 


Error Code 

Meaning 

Error Data Output 1 

64 

Protected File - Attempt to -access a file via 
.RAND with protection codes 2 or 3* or to .SEEK 
a disk file with protection code of -3. 

CAL adr,dv & unit, CAL fen, UIC 

65 

Unrecoverable Magtape Error - 

Magtape status word, dv, CAL, fen 

66 

Relative Block Not Within File - Attempt to access 
(via . RTRAN) a block not within the limits of the 
current file [i.e., block 0 or n+1] ) . 

CAL adr,dv & unit, CAL fen, UIC, filnam 

67 

Illegal DECdisk Word Transfer Starting Address or 

Count - When issuinq an .RTRAN: 

a. The argument which specifies the first word 
in the DECdisk block -fee be- transferred is 
either 0 or greater than 354 . 

O 

b. The argument which specifies the number of 
words to be transferred exceeds the physical 
block size (i.e., 0<no. words< 253-word 
starting address) . 

CAL adr,dv & unit, CAL f cn , UIC , filnam 

70 

Buffer Size Too Small - The size of the buffer alio- 
cated by .GTBUF and .GVBUF Macros (established during 
System Generation) is not large enough for the handler 
attempting to utilize them. 

CAL adr,dv & unit, CAL fen, UIC 

71 

Empty UFD - A .SEEK or .RAND was attempted to a UFD 
which did not contain any files. 

CAL adr,dv & unit, CAL fen, UIC, filnam 

72 

Input Paritv or Write Check Error - Hardware error 
detected; type CTRL R to continue. 

block no. ,dv & unit, CAL fen, UIC 

73 

Null File Name - A .SEEK, .ENTER, . DLETE, . FSTAT or 

CAL adr,dv & unit, CAL fen, UIC 

.RAND was issued with a null filename argument. 



























IOPS ERROR CODES (Cont.) 


Error Code 

Meaning 

Error Data Output 1 

74 

Disk System File Structure Degradation 3 - 

a. Attempt to turn off a bit in a submap 
that is already off. 

b. Attempt to write block 0 in a sequential 
f ile. 

c. Attempt to use block 0 as a UFD block. 

d. Nonexistent submap. 

CAL adr,dv & unit, CAL fen, UIC, filnam 

75 

Disk System File Structure Degradation - 
Word 1 of submap is greater than word 0 or 
is 0 or negative. 

CAL adr,dv & unit, CAL f cn , UIC , filnam 

76 

Disk System File Structure Degradation - 
Word 376g of the first UFD or MFD black is 
not -1. Type CTRL R to continue. 

CAL adr,dv & unit, CAL f cn , UIC , filnam 

77 

Undersized or Nonexistent CTRL Q AREA - The 
system attempted to utilize a CTRL d 'area 
(via CTRL Q, QDUMP , GET, PUT, GETP , GETT , 

GETS keyboard commands) which was nonexistent 
or of insufficient size for the amount of core 
available. (The CTRL Q area is created 

during System Generation. ) 

The address (15 -bits) to which control 
would have been passed if the requested 
operation had been successful. 


NOTES 

1 Abbreviations: addr =* address dv = device fen = function filnam = file name 

1 Recovery procedures for IOPS 61: 

1) Repeat operation which causes error. 

2) If error persists, remount DECtape on another drive and repeat step 1. 

3) If error still persists and you are very familiar with DECtape file structure and have a reasonably current directory 

listing, proceed as follows: 

a. Using DUMP, obtain a listing of each file in the directory listing. (The directory listing provides the start- 
ing block number for each file. The last (link) word in each block points to the next block. Negative block 

numbers indicate reverse recording. Last block has a link of 777777.) 

b. Use PIP to block copy each file onto a good tape. 

c. Use PATCH to construct a directory on the new tape. DO NOT WRITE ON THIS TAPE - IT HAS NO BIT MAPS. 

d. Use PIP to transfer each reconstructed file to still another tape (this reconstructs the master and file bit maps). 
3 These errors usually result from hardware failure or inadvertent manipulation of disk structure data areas. 



APPENDIX E 


LINKING LOADER AND SYSTEM LOADER ERRORS 


The following error codes are output by both the Linking Loader and the 
System Loader. When output by the Linking Loader, the errors are 
identified as shown below. When output by the System Loader, the 
errors are identified as ".SYSLD n" instead of ".LOAD n" . 


Error 


.LOAD 1 


.LOAD 2 


• load 3 


.LOAD 4 


.LOAD 5 


Memory overflow - the Loader's symbol table 
and the user's program have overlapped. At 
this point the Loader memory map will show 
the addresses of all programs loaded suc- 
cessfully before the overflow. Increased 
use of COMMON storage may allow the pro- 
gram to be loaded as COMMON can overlay the 
Loader and its symbol table, since it is 
not loaded into until run time. 

Input data error - parity error, checksum 
error, illegal data code, or buffer over- 
flow (input line bigger than Loader's 
buffer) . 

Unresolved Globals - any programs or sub- 
routines required but not found, whether 
called explicitly or implicitly, are 
indicated in the memory map with an ad- 
dress of 00000. If any of the entries in 
the memory map has a 00000 address, 
loading was not successful; the cause of 
trouble should be remedied and the pro- 
cedure repeated. 

Illegal .DAT slot request - the .DAT slot 
requested was; 

a. Out of range of legal .DAT slot 
numbers , 

b. Zero, 

c. Unassigned; that is, was not set 
up at System Generation Time or 

was not set up by an ASSIGN command. 

Program segment greater than 4K - the program 
segment being loaded in page Mode exceeds a 
Page Bound (i.e., prograifi is greater than 4K) . 


E-l 



APPENDIX F 


PDP-15 ASCII/ HOLLERITH CORRESPONDENCE 


The following table shows the correspondence between the PDP-15 64 
character graphic subset of ASCII and the DEC 029/026 Hollerith codes. 
Both 029 and 026 codes are identical for numberic and alphabetic 
characters but very for symbol representation. The 029 code, except 
as indicated by brackets [] , is a subset of the standard Hollerith 
punched card code specified in ANSI standard X3. 26-1970. Characters 


in parentheses denote the 1963 character set. 


ASCII 

HOLLERITH 

ASCII 

HOLLERITl 

H 


7-BIT 

DEC 029 

DEC 026 


7-BIT 

DEC 029 

DEC 026 

CHAR. 

CODE 

CODE 

CODE 

CHAR. 

CODE 

CODE 

CODE 

Space 

40 



@ 

100 

8-4 

8-4 

1 

41 

[11-8-2] 

12-8-7 

A 

101 

12-1 

12-1 

It 

42 

8-7 

0-8-5 

B 

102 

12-2 

12-2 

# 

43 

8~3 

0-8-6 

C 

103 

12-3 

12-3 

$ 

44 

11-8-3 

11-8-3 

D 

104 

12-4 

12-4 

% 

45 

0-8-4 

0-8-7 

E 

105 

12-5 

12-5 

& 

46 

12 

11-8-7 

F 

106 

12-6 

12-6 

r 

47 

8-5 

8-6 

G 

107 

12-7 

12-7 

( 

50 

12-8-5 

0-8-4 

H 

110 

12-8 

12-8 

) 

51 

11-8-5 

12-8-4 

I 

111 

12-9 

12-9 

* 

52 

11-8-4 

11-8-4 

J 

112 

11-1 

11-1 

+ 

53 

12-8-6 

12 

K 

113 

11-2 

11-2 

i 

54 

0-8-3 

0-8-3 

L 

114 

11-3 

11-3 

- 

55 

11 

11 

M 

115 

11-4 

11-4 

. 

56 

12-8-3 

12-8-3 

N 

116 

11-5 

11-5 

/ 

57 

0-1 

0-1 

0 

117 

11-6 

11-6 

0 

60 

0 

0 

P 

120 

11-7 

11-7 

i 

61 

1 

1 

Q 

121 

11-8 

11-8 

2 

62 

2 

2 

R 

122 

11-9 

11-9 

3 

63 

3 

3 

S 

123 

0-2 

0-2 

4 

64 

4 

4 

T 

124 

0-3 

0-3 

5 

65 

5 

5 

U 

125 

0-4 

0-4 

6 

66 

6 

6 

V 

126 

0-5 

0-5 

7 

67 

7 

7 

W 

127 

0-6 

0-6 

8 

70 

8 

8 

X 

130 

0-7 

0-7 

9 

71 

9 

9 

Y 

131 

0-8 

0-8 

: 

72 

8-2 

11-8-2 

Z 

132 

0-9 

0-9 

t 

73 

11-8-6 

0-8-2 

[ 

133 

12-8-2 

11-8-5 

< 

74 

12-8-4 

12-8-6 

\ 

134 

11-8-7 

8-7 

= 

75 

8-6 

8-3 

] 

135 

0-8-2 

12-8-5 

> 

76 

0-8-6 

11-8-6 

* (+) 

136 

12-8-7 

8-5 


77 

0-8-7 

12-8-2 

M 

137 

0-8-5 

8-2 










NOTES: 


1. ASCII codes 00-37 and 140-177 have no corresponding codes in 
the DEC 026 & 029 Hollerith sets and therefore, are not pre- 
sented here. 

2. ALT MODE is simulated by a 12-8-1 punch (multiple punch A8) . 

3. End-of-file corresponds to a 12-11-0-1 punch (multiple punch 
AJ0- ] . 

4. The card reader hardware supplies the binary equivalent of 
Hollerith code which in turn, is mapped into 7-bit ASCII by 
the Card Reader Handler. 
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APPENDIX G 


DOS-15 CHECKOUT PROCEDURES 


INTRODUCTION 

The purpose of the DOS-15 checkout package is to show that the system 
has been properly installed onto DECdisk or Disk Pack. It does so by 
briefly testing all the basic pieces of the DOS-15 System Software. 
The following is a list of programs tested: 

1. DOS-15 Resident and Nonresident Monitors 

2. PIP 

3. FORTRAN Compiler and Object Time System 

4. MACRO Assembler 

5. Linking Loader and System Loader 

6. Chain and Execute System Programs 

7. System Device Handler (DECdisk or Disk Pack) 

8. Paper Tape Reader Handler 

9. Teleprinter Handler 

10. BATCH System Commands 

11. DOSSAV System SAVE/RESTORE program 

The batch paper tapes for the DOS-15 Checkout Package are identified 
as follows: 


RF.CHK (for the RF15 DECdisk System) DEC-15-CIDA-PA 
RP.CHK (for the RP02 Disk Pack System) DEC-1 5-CTAA-PA 

CHECKOUT PACKAGE OPERATION 

Load the DOS-15 System as described in Chapter 10. Place the paper 
tape labeled "RF.CHK" (if DECdisk system) or "RP.CHK" (if Disk Pack 
system) in the paper tape reader and type: 

BATCH PR 


The commands contained on the tape will then run the checkout package 
to completion as indicated on the teleprinter before leaving Command 
Batching Mode. 
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CHECKOUT PACKAGE RESULTS 


The result from the FORTRAN Object Time System (.shortly after the 
GLOAD command) should be: 


-J0.123 5E+J33 


Also the result of the Chain and Execute programs should be: 


-0.1234E+05 


Attached is a copy of the source listing of the DOS-15 Batch Tape 
Checkout Package. 

Please note that if you have a Disk Pack as your system device, this 
listing should read DP in commands instead of DK. Your Batch tape is 
correct for your system device. 


SJOB 

L 

TURN ON AND RUN IN BANK MODE, THIS MODE WILL STAY IN 
EFFECT UNTIL TURNED OFF VIA 'PACE ON' OR 'BANK OFF’BANK ON 
LOGIN REN 

SJOB LOOK AT CONTENT OF ' BNK ' UlC AND U I C NOT PRESENT 

L 

THIS TEST SHOWS HOW TO REFERENCE DIFFERENT U I C * S VIA P IPP I P 
L TT- DK <3NK> 

L TT-OK 
SJOB 

L 

THESE COMMANDS TEST THE F01L0W1NGI 

DOS-15 RESIDENT AND NON-RESIDENT MONITORS 
PIP system PROCRAM 
PAPERTAPE READER HANDLER 
DISK HANOLERS <A,L> 

SJOB 
R PJP 

A DK 1/TT 2/PP 3/PR 4 
R PIP 

SJOB ESTABLISH USER AREA AND PIP ON FILE, 

PIP 
N OK 

T DK F4TEST SRC*>PR (A) 

SOATA 

1 READ (1,100) A 

100 FORMAT (£12,4) 

CALL MIN (A,B> 

WRITE (2,1?0) B 

STOP 

END 
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SEND 
l TT-DK 


T OK 
SOATA 

MIN SRC-PR 

(A) 


.title 

MIN 


.globl 

MIN, , DA 

M J N 

0 



JMS* 

.DA 


JMP 

, *2*1 

MJN1 

. DS A 

0 

m J N2 

, OSA 

0 


lac* 

MINI 


dac* 

M I N2 


IS l 

MINI 


ISH 

MIN2 


lac* 

MINI 


tad . 

(400000 


DAC* 

M I N2 


JMP* 

• END 

MIN 


SEND 
L TT-OK 

V DK F 4 TEST SRC (A) 

V OK MIN SRC (A) 

SJ08 TEST EXPANDED FORTRAN COmPIL 


ER 


l 

THE FOLLOWING COMMANOS WILL TEST THE FORTRAN COMPILER 
BY GENERATING F4TEST BIN From F4TEST SrC, 

A OKA -13/TTA -12/DKA -11 
R fa 

r 4 

9*F 4TEST 

SJOB USE B , T, N» AND X SWITCHES IN MACRO LIST TEST 
L 

THE FOLLOWING COMMANDS WILL TEST THE MACRO ASSEMBLER 
BY ASSEMBLING M J N SRC AND GENERATING Min BIN, 

A DK A -l4| -i3i -ll/TTA -12.-10 
P MACRO 
MACRO 

R.T.n.x-mIn 

SJOB list DIRECTORY TO SHOW NEW FILES AND OFSCRlPToRS, 

P IP 

L TT-DK (PI 

SJOB 

L 

THE NEXT GROUP OF COMMANDS WILL TEST * 

.LOAO-ILINKING LOADER) 

ots-fortran object time system 

.SYSl 0-<SYSTEM LOADER) 

THERE WILL BF ONE LINE OF DATA OUTPUT ON THE TELETYPE FROM 
RUNNING THE FORTRAN AND MACRO (LINKED) PROGRAMS, 

SJ08 DEMONSTRATE 33 L.u, CODE FOR IDENTIFYING RELOCATABLE PGM S . 
A PR 1/TTA 2 
GIOAO 

P-F4TEST.MINS0ATA 

123,4567 

SJOB 


G-3 



L 

THE FOLLOWING COMMANDS WILL CHAIN THE FORTRAN AND MACRO TEST 
PROGRAM, AND THEN EXECUTE Them, THJS WILL COMPLETE THE 
TESTS USING TWO SYSTEM PROGRAMS » CHAIN AND EXECUTE, 
note that loading ADDRESSES change with core SJ?E (I.E, 

16K, 20K. ETC,) 

A DKA -6,-4,,-1/NON -5 
R CHAIN 
CHAJN 

F4TEST F4TEST.MIN SJOB EXECUTE CHAIN JUST B U I U T 
A BRA 1/TTA 2 
E F 4 TEST 
SQATA 

125 , 45E*2 
S JOB 

L 

the dos-15 checkout package has just completed all of 
THE REQUIRED TESTS, 
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APPENDIX H 


DOS TERMS AND ACRONYMS 


Terms unique to the PDP-15 DOS Software System are listed and 
described in the followinq table. The acronyms for each term are 
also given. 


TERM 

ACRONYM 

DEFINITION 

Bad Allocation Table 

BAT 

A device (disk) table which in- 
dicates, in storage blocks, any 
faulty disk areas in which data 
cannot be stored. 

Master File Directory 

MFD 

A master device (disk) file di- 
rectory which contains pointers 
to all user directories (UFD's) 
within a disk device. 

Monitor Identification Code 

MIC 

The master system password which 
permits full access to all files 
within the system. This code 
identifies the system manager 
and should be used only by him. 

Storage Allocation Table 

SAT 

The device (disk) table which 
stores busy, not-busy indicators 
for the disk storage area. 

System Block 

SYSBLK 

The system table which contains 
the names, locations, and loading 
and starting parameters for all 
system programs within the oper- 
ating system. 

User File Directory 

UFD 

File directories for each user who 
established disk file storage 
areas within the system. 

User File Directory Table 

UFDT 

The system directory table which 
maintains the relationship between 
the system's .DAT slots and each 
unique user identification code 
(UIC) . 

User Identification Code 

UIC 

A password entered by a user to 
uniquely define himself and any 
files which he may enter. If 
necessary, a user may enter more 
than one UIC to establish several 
unique sets of files. Since only 
one user may emplqy the system at 
any one time, the current UIC is 
the last logged-in UIC. 
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INDEX 


..ADS and .ABSP Binary, 3-8 
Absolute binary code, 3-8 
Access to files, 4-4 
directoried, 3-6, 4-7 
non-directoried, 4-6 
random, 4-4 
random-sequential, 4-4 
sequential, 3-5, 4-5, 4-6, 6-3 
Allocating buffer space, 6-14, 

6-15, 6-16 

Alphanumeric data, 6-7 
ALT MODE, 6-9, 6-10, 8-2 
API (Automatic Priority Interrupt) , 
3-4, 4-2 

API ON/OFF command, 8-19 
ASCII 

character packing (sixbit) , 5-2 

Hollerith correspondence, F-l 
packing and unpacking routines, B-l 
standard character set, A-l 
Assembler, MACRO, 2-2, 2-3 
ASSIGN command, 4-1, 8-12, 8-28 
Automatic Priority Interrupt (API) , 
3-4, 4-2, 8-19 


Bank mode operation/ 3-9 
BANK ON/OFF command, 8-20 
BAT (Bad Allocation Table) , H-l 
BATCH command, 8-26 
Batching commands, 8-25 to 8-28 
job control commands, 8-26 
operator commands, 8-26 
restrictions, 8-27 
Binary code, absolute, 3-8 
Binary, relocatable, 3-7, 3-8 
.BLOCK pseudo-op, 6-14 
Bootstrap program, 7-2, 7-8, 7-9 
restart, 7-9 
Bracket ([ ] ) usage, 5-2 
Buffer, I/O, 3-7 
header words, 4-2 
overflow, 6-6, 6-13 
pool, 4-11 

size for logical records, 6-4 
size for VT display, 8-19 
space allocation, 6-14 to 6-16 
BUFFS command, 8-13 

Calendar date entry, 8-21 
Card files, 3-5 

Card Reader handler, 9-27 to 9-29 
Carriage return, 5-1, 6-9,6-10, 8-2 
CHAIN and EXECUTE programs, 2-7 
advantages, 2-7 
disadvantages, 2-8 
CHAIN .DAT slot assignments, 9-9 
CHANNEL 7/9 command, 8-20 


Characters , 

ASCII, A-l, F-l 
(nonprinting) for teleprinter 
functions, 9-12 
Checkout package, 1-10 
procedures, G-l 
Checksum, 6-5, 6-9 
.CLEAR macro, 6-17 
.CLOSE macro, 6-17, 6-31 
Command Batching Mode restric- 
tions, 8-27 

Command default settings VT 
Display, 8-19 
Command Batching Mode, 3-4 
Commands 

Batching keyboard, 8-25 to 8-28 
core allocation, 8-13, 8-14 
core image Save/Restore, 8-14 to 
8-17 

DOSSAV , 7-3, 7-4 

DOSSAV examples, 7-5, 7-6 
file protection, 8-8 
Input/output, 6-2 
I/O device assignments, 8-10 
keyboard, 3-3, 3-4, 8-1, 8-2 
miscellaneous, 8-19 
Monitor, 5-1 

program start/restart/continue, 
8-23, 8-25 

to request system information, 

8-3 

VT15 Display, 8-17 to 8-19 
Communications, I/O, 6-1 
Compiler, FORTRAN IV, 2-1 
Console keyboard, 8-1 
Console teleprinter, 3-3 
Core allocation commands, 8-13, 
8-14 

Core image Save/Restore commands, 
8-14 to 8-17 


CTRL 

commands , 

8-2 

CTRL 

c, 

8-23, 

8-26 

CTRL 

P, 

8-23 


CTRL 

Q # 

8-15 


CTRL 

R, 

8-25, 

8-26 

CTRL 

s. 

8-25 


CTRL 

T, 

8-25, 

8-26 

CTRL 

u. 

8-2 


CTRL 

X, 

1-5, 

8-19 


.DAT (Device Assignment Table) 

3-5, 4-1, 6-16, 8-8 
.DAT slot assignments, 9-3 to 9-30 
CHAIN, 9-9 
DTCOPY, 9-10 
DUMP, 9-8 

EDIT, EDITVP , EDITVT, 9-6 
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.DAT slot assignments (continued) 
EXECUTE, 9-9 
FOCAL, 9-5 
FORTRAN IV (F4), 9-3 

Linking Loader and DDT, 9-6 
MACRO-15, 9-4 
MTDUMP , 9-10 

PATCH, 9-8 
PIP, 9-7 
SGEN , 9-7 

SRCCOM, 9-9 
8TRAN, 9-10 
89TRAN, 9-10 
UPDATE, 9-8 

. DAT/. UFDT slot assignments, 8-13 
Data 

fields, 6-4 
storage, 6-10 
transfers, 6-1 
transfer program, 2-10 
Data modes, see Modes 
$DATA command, 8-27 
DATE command, 8-21 

DDT (Dynamic Debugging Technique) 2-9 
DECdisk and Disk Pack handlers, 

9-18 to 9-22 
DECtape 

directories, 4-6 
file structure, 4-6 
handlers, 9-17, 9-18 
DECtape COPY (DTCOPY) Program, 2-11 
Default device assignments, 4-1 
Default protection code, 3-7, 8-9 
Delimiters, keyboard commands, 8-2 
Device 

assignments, 4-1 
capabilities, 6-29 
independence, 3-4 
Device, 

directoried, 3-6 
file-oriented, 3-6 
system, 1-6 

Device Assignment Table (.DAT), 3-5, 
4-1, 6-16, 8-8 

Device dependent I/O programming, 
6-33 

Device handler characteristics, 6-29 
Device handlers, 3-4, 3-5, 9-10 
also see Handlers, device 
Direct access, 3-5, 4-4 
Directoried data access, 4-7 
Directoried devices, 3-6 
Directoried mode, 4-6 
Disk 

data access, 4-7, 4-8 
file structure, 4-8, 4-11 
handlers, 4-11, 9-18 
Disk pack handlers, 9-18 to 9-22 
Disk restoration (DOSSAV) , 7-2, 

example, 7-5 
tapes, 7-1 
Disk save, 7-6, 7-7 
Display mode, V?15, •8HL7 


•DLETE macro, 6-18 
DOSSAV (disk restoration), 7-2 
commands, 7-3 
error conditions, 7-7 
restart procedures, 7-8 
DTCOPY (DECtape COPY program) , 2-11 
.DAT slot assignments, 9-10 
DUMP .DAT slot assignments, 9-8 
Dump mode, 6-3, 6-6, 6-12, 6-14, 
6-33 

DUMP program, 2-9, 8-16 
Dynamic Debugging Technique (DDT) , 
2-9 


Editing features, keyboard com- 
mands, 8-2 

Editing programs, EDIT, EDITVP, 
EDITVT, 2-10 

.DAT slot assignments, 9-6 
$END command, 8-27 

End of file (EOF) , 6-6, 8-22 

End of medium (EOM) , 6-6 

.ENTER macro, 6-18, 6-33 
Errors, 10-5 
batching, 8-28 
DOSSAV, 7-7, 7-8 
IOPS, D-l 

Linking Loader, E-l 
system, E-l 

Example I/O programming, 6-33 
EXECUTE program, 2-7 

.DAT slot assignments, 9-9 
$EXIT command, 8-27 
.EXIT macro, 5-6 
External globals, 3-9 


Features of system, 1-2 
Fields, data, 6-4 
File 

directories, 3-6 
integrity, 6-44 
organization, disk, 4-11 
processing, sequential, 6-3 
protection 3-7, 4-9, 8-8 

File-oriented devices, 3-6 
Files 

definition of, 4-2 
direct access, 3-5 
sequential, 3-5 

Floating point processor software, 7-1 
FOCAL .DAT slot assignments, 9-5 
FOCAL interpreter, 2-4 
Form control characters, 9-26 
FORTRAN IV (F4), 2-2 

Compiler, 2-1 
.DAT slot assignments, 9-3 
.FSTAT macro, 6-19 
•FULL and . FULLP pseudo-ops, 3-8 
Function characters (non-printing) 
for teleprinter, 9-12 
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GET command, 8-16, 8-17 
-GET macro, 5-4 
Global symbols, 2-3, 3-8 
external, 3-9 
internal, 3-9 
. GLOBL pseudo-op, 3-9 
GRAPHIC15 programs, 2-11 
. GTBUF macro, 5-5 
. GVBUF macro, 5-5 


HALF ON/OFF command, 8-19 
HALT command, 8-22 
Handler characteristics, 6-29 
Handlers, I/O device, 3-5, 9-1 to 9-30 
Card Reader, 9-27 
DECdisk, 9-18 
DECtape, 9-17 
Disk, pack, 9-18 
DOS-15 (summary) , 9-1 

Line Printer, 9-25 
Magtape, 9-23 
Paper Tape Punch, 9-15 
Paper Tape Reader, 9-15 
Teleprinter, 9-11 
VP15 Storage Tube, 9-29 
Hardware 

errors, 7-8 
malfunction, 7-9 
minimum, 1-3 
optional, 1-5 
Hardware Readin Mode, 7-3 
Header word pair, 6-4, 6-12 
format, 6-5 

Hollerith/ASCII correspondence, F-l 


Image Alphanumeric Mode, 6-6, 6-10 
Image Binary Mode, 6-6, 6-10 
Image Mode, 6-3, 6-33 
Independence, device, 3-4 
Initializing 
handler, 6-29 
system, 7-1 

. INIT macro, 6-20, 6-29 
Input/ Output (I/O) 
buffers, 3-7 
commands, 6-2 
communication, 3-4, 6-1 
control characters, A-l 
data mode terminators, C-l 
device assignment commands, 8-10 
to 8-13 

device handlers, see Handlers, 

I/O device 

device specification, 6-16 

errors, 10-5 

functions. Magtape, 9-24 

macro descriptions, 6-16 to 6-28 

macro syntax, 6-29 

macros, using, 6-29 

process, 4-1 

programming examples, 6-33 to 6-43 
transfer to director led device, 6-31 


Input/Output Programming System 
(IOPS) , 3-2 

INSTRUCT command, 8-5 
Internal globals, 3-9 
Interpreter, FOCAL, 2-4 
. IODEV pseudo-op, 6-16 
IOPS (Input/Output Programming 
System) , 3-2 

ASCII mode, 6-6, 6-7 
Binary mode, 6-6, 6-7, 6-9 
error codes, D-l 
errors, 3-10 
mode, 6-3 


$ JOB , batching mode job 
separator, 8-26 


KEEP ON/OFF command, 8-13 
Keyboard commands, 3-3, 3-4, 8-1 
8-2, 8-3 

editing features, 8-2 
Keyboard operations, 10-1 
example, 10-2, to 10-8 


Languages, 2-1 

FOCAL Interpreter, 2-4 
FORTRAN IV Compiler, 2-1 
MACRO Assembler, 2-2 
Library, science, 2-2 
Library subprograms, 2-8 
Library UPDATE program, 2-11 
Line Printer handler, 9-25 to 9-27 
Line Printer on/off, 8-20 
Line terminators, 6-9 
Linking Loader, 2-1, 2-8, 8-25 
•DAT slot assignments, 9-6 
errors, 3-10, E-l 
Loader control, 3-8 
Loader, system, 3-1 
Loading commands, system program 
8-23, 8-24 
Loading 

Monitor, 7-8 
program, 3-9 
system, 7-1 
Logical record, 6-4 
format, 6-3 

terminating condition, 6-4, C-l 
terminators, 6-12, 6-13 
LOG command, 8-22 
LOGIN, 3-6 
LOGIN command, 8-8 
LOGOUT command, 8-9 
LP ON/OFF command, 8-20 


Macro combinations, I/O, 6-30 
Macros, 2-3 

Macro sequence, I/O, 6-31 
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Macros, I/O, 6-2, 6-16 to 6-28 


.CLEAR, 

6-17 

.CLOSE, 

6-17 

.DLETE, 

6-18 

. ENTER , 

6-18 

•FSTAT, 

6-19 

. INIT, 

6-20 

.MTAPE, 

6-21 

. RAND , 

6-21 

. READ , 

6-22 

.REN AM, 

6-23 

. RTRAN, 

6-23 

.SEEK, 

6-24 

.TRAN, 

6-25 

.USER, 

6-26 

.WAIT, 

6-27 

. WAITR, 

6-27 

.WRITE, 

6-28 

Macros, system. 

•EXIT, 

5-6 

.GET, 

5-4 

.GTBUF , 

5-5 

.GVBUF , 

5-5 

. OVRLA , 

5-6 

.PUT, 

5-3 

.TIMER, 

5-7 


Magnetic tape (Magtape) , 4-5 

handlers, 9-23 to 9-25 
Magnetic Tape Dump (MTDUMP) utility 
program, 2-9 

MACRO Assembler, 2-2, 2-3 
MACRO-15 .DAT slot assignments, 9-4 
Mass storage, 4-3 
DATE command, 8-21 
devices, 6-4 

Master File Directory (MFD), 3-6, 
4-8, H-l 

Messages, see Errors 

MFD see Master File Directory 

MIC see Monitor Identification Code 

MICLOG command, 8-9 

Miscellaneous commands, 8-19 

Modes 

Bank, 3-9, 8-20 
Command Batching, 8-25 
Data, 4-3, 6-6, 6-7, 6-14 
Dump, 6-12, 6-14, 6-33 
Image, 6-3, 6-33 
Image Alphanumeric, 6-10 
Image Binary, 6-10 
IOPS, 6-3 
IOPS Binary, 6-9 
Page, 3-9, 8-20, 9-29 
VT15 Display, 8-17, 8-18 
Modification procedures, 7-10 
Monitor, 1-1 
commands, 5-1 
destruction, 7-9 
errors, 3-10, 10-5 
functions, 3-1 
loading and starting, 7-8 
Monitor Identification Code (MIC) , 
2-6, 3-6, 7-1, 8-9, H-l 
Monitor/User interaction, 3-3 


.MTAPE macro, 6-21 
MTDUMP, 2-9 

.DAT slot assignments, 9-10 


Non-directoried access, 4-6 
Non-parity IOPS ASCII, 6-8 
Nonresident Monitor, 3-1 


Object code, 3-7 

Object program, relocatable, 2-1 
Object Time System (OTS) , 2-2 

Operating errors, DOSSAV, 7 -7, 7 -8 
Operating procedures, 10-1 
saving/restoring, 7-3 
Overflow of buffer, 6-6, 6-13 
. OVRLA macro, 5-6 


Packing routine, IOPS ASCII, B-2 
Page Mode operation, 3-9 
PAGE ON/OFF command, 8-20 
Paging Mode VT15, 8-18, 9-29 
Paper tape 
files, 3-5 
I/O, 6-12 

Paper Tape Punch handlers, 9-14 , 9-15 
Paper Tape Reader handlers , 9-15, 9-16 
Parity, 6-8, 6-9 
PATCH .DAT slot assignments, 9-7 
PATCH utility program, 2-5, 2-6 
$PAUSE command, 8-27 
PDP-8 to PDP-9 Translator (89TRAN) , 
2-12 

PDP-8 to PDP-15 Translator (8 TRAN ) , 
2-11 

Peripheral Interchange Program 
(PIP), 2-10 

.DAT slot assignments, 9-7 
Priority Interrupt (PI) , 3-4 

skip chain order, 8-3 
Programming example, I/O, 6-33 to 
6-43 

Programs, 2-1 
loading, 3-9 

Program start, restart, continue 
commands, 8-2, 8-23, 8-25 
PROTECT command, 8-9 
Protection codes, 3-7, 4-9, 8-9 
default code, 3-7 
PUT command, 8-15 
•PUT macro. 5-3 


QDUMP command, 8-15 
Question/answer sequence, SGEN , 2-5 


•RAND macro, 6-21 
Random access, 4-4 
Random-sequential access, 4-4 
•READ macro, 6-3, 6-22 
Real-time clock, 1-6 



Reassignment of .DAT slots, 8-12 

Records 

definition of, 4-2 
logical, 6-3 

Relocatable binary, 3-7, 3-8 
Relocatable object program, 2-1 
Relocatable output, 3-7, 3-8 
•RENAM macro, 6-23 

REQUEST command, 8-8,8-10,8-11,8-28 

Resident Monitor, 3-1 

Restart 

bootstrap, 7-9 
DOSSAV , 7-8 

3ystem program, 8-23 
Restore core image, 8-16 
Restoring procedures, 7-3 
Retrieval Information Block (RIB), 4-11 
rF 15 DECdisk , 1-6 see also Disk 

RP#2 Disk Pack, 1-6 see also Disk Pack 
. RTRAN macro, 6-3, 6-23, 6-33 
RUBOUT, 8-2 

SAT (Storage Allocation Table) , H-l 

Saving software, 7-3 

Science library, 2-2 

SCOM command, 8-3 

SCOM (System Communication Table) , 

3-2, 6-16 

Scroll mode, VT15, 8-18 

.SEEK macro, 6-24, 6-33 

7-bit ASCII characters, 6-7, 6-8 
Sequential access, 4-4, 4-11 
Sequential files, 3-5 
processing, 6-3 
structure, 4-5 
SGEN , 2-4, 2-5, 7-10 

.DAT slot assignments, 9r7 . 

Sixbit file representation, 5-2 
ASCII character packing, 5-2 
Software, 7-1 
Software, system, 1-6, 1-8 
how supplied, 1-10 
Source Compare Program (SRCCOM) , 

2-11 

.DAT slot assignments, 9-9 
Spaces, 5-1, 5-2 
Starting 

Monitor, 7-8 
system, 7-1, 7-2 
Storage device, 6-12 
non-mass, 6-8, 6-33 
Subprograms, library, 2-8 
Symbolic names, 6-35 
Symbols, global, 2-3, 3-8, 3-9 
Syntax, I/O macro, 6-29 
SYSBLK System Block, H-l 
. SYSLD see System Loader 
System 

concepts, 3-1 
default parameters, 8-3 
device, 1-6 
features, 1-2 
hardware, 1-3 
information, commands to 
request, 8-3 


System (cont.) 

initialization, 7-1 
loader, 3-1 

loader errors, 3-10, E-l 
macros, expansions, 5-2 to 5-7 
macros, summary, 5-1 
modification procedures, 7-10 
program errors, 10-5 
program loading commands, 8-23, 

8-24 

programs, 2-1 
software, 1-6, 1-8, 7-1 
startup, 7-2 

System Communication Table (.SCOM), 
3-2, 6-16 

System Generator (SGEN), 2-4, 2-5, 
7-10 


Tab, 5-1 

Tailoring system, 7-10 
Teleprinter, 3-3 
console, 8-1 

Teleprinter device handler, 8-20, 

9-11 to 9-13 

Teleprinter non-printing function 
characters, 9-12 
Terminating condition, logical 
record, 6-4, C-l 
Termination of program, uncondi- 
tional, 8-22 
Terminator 
I/O, 6-31 

keyboard command, 8-2 
of logical record, 6-12, 6-13 
Terms and acronyms, H-l 
Text Editor programs, 2-10 
Text output, switching between 

teleprinter and VT04 screen, 8-19 
TIME command, 8-21 
•TIMER macro, 5-7 
TIMEST command, 8-22 
Track count, 9-23 
.TRAN macro, 6-3, 6-25 
8 TRAN (PDP-8 to PDP-15 Translator 
program) , 2-11 

.DAT slot assignments, 9-10 
89TRAN (PDP-8 to PDP-9 Translator 
program) , 2-12 
.DAT slot assignments, 9-10 
Transfers to directoried devices, 
6-31 

3 3 TTY ON/OFF -command, 8-20 


UFD see User File Directory 
.UFDT see User File Directory 
Table 

UIC see User Identification Code 
Unpacking routines, IOPS ASCII, 

B-l 

Up arrow (i ) usage, 8-19 
UPDATE (Library UPDATE program) , 2-11 
.DAT Slot assignments, 9-8 


X-5 



3-6, 4-8 


User File Directory (UFD) , 

H— 1 

User File Directory Table, 3-6, 4-9, 
H-l 

User Identification Code, 3-6, 4-8, 
H-l 

.USER macro, 6-26 
Using I/O macros, 6-29 


Vertical form control characters, 9-26 
VP15A Graphics software, 2-12 
VP15A Storage Tube Display, 9-29,9-30 
VTJ34 Display Console, 1-5, 8-19 
VT15 Display 

buffer size, 8-19^ 
clearing display screen, 8-18 
command default settings, 8-19 
commands, 8-17 to 8-19 
editing, 8-18 
modes, 8-17 

text switching between teleprinter 
and VT15, 8-19 

VT15 Graphics software, 2-11 
VT ON/OFF command, 8-18 


.WAIT macro, 6-27 

•WAITR macro, 6-27 

Word count, 6-4, 6-6, 6-12 

for .READ/. WRITE macros, 6-14 
Word Pair Count, 6-4, 6-13 
Words, definition of, 4-2 
.WRITE command (macro), 6-3, 6-28 


X4K ON/OFF command, 8-14 


X-6 



HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PDP-8 & PDP-12 
Digital Software News for the PDP-11 
Digital Software News for the PDP-9/15 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office. 

Questions or problems concerning Digital's Software should be reported to 
the Software Specialist. In cases where no Software Specialist is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided in the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete investigation. An answer will be sent to the 
individual and appropriate topics of general interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative. U.S.A. customers may order 
directly from the Program Library in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request it. For further information 
please write to: 


DECUS 

Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 
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READER'S COMMENTS 


Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness 
of its publications. To do this effectively we need user feedback — your critical evaluation of 
this manual . 

Please comment on this manual's completeness, accuracy, organization, usability and read- 
ability. 


Did you find errors in this manual? If so, specify by page. 


How can this manual be improved? 


Other comments? 


Please state your position. 



Date: 

Name: 


Organization: 


Street: 


Department: 


City: 

State: 


Zip or Country 
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